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第 一 章 以 太 坊 是 什么 ? 


1.1 以 太 坊 是 什么 ? 























以 太 坊 是 一 个 全 新 开放 的 区 块 链 平台 , 它 允 许 任何 人 在 平台 中 建立 和 使 用 通过 区 
块 链 技术 运行 的 去 中 心 化 应 用 。 就 像 比特 币 一 样 ， 以 太 坊 不 受 任何 人 控制 ， 也 不 
归 任 何人 所 有 一 一 它 是 一 个 开放 源 代 码 项 目 ， 由 全 球 范 围 内 的 很 多 人 共同 创建 。 
和 比特 币 协议 有 所 不 同 的 是 ， 以 太 坊 的 设计 十 分 灵活 ， 极 具 适 应 性 。 在 以 大 坊 平 
台 上 创立 新 的 应 用 十 分 简便 ， 随 着 Homestead 的 发 布 ,任何 人 都 可 以 安全 地 使 用 
该 平台 上 的 应 用 。 


1.2 下 一 代 区 块 链 


区 块 链 技术 是 比特 币 的 底层 技术 ， 这 一 技术 第 一 次 被 描述 是 在 中 本 聪 2008 年 发 
表 的 白皮书 “比特 币 : 点 对 点 电子 现金 系统 ”中 。 区 块 链 技术 更 多 的 一 般 性 用 途 
在 原 书 中 已经 有 所 讨论 ， 但 直到 几 年 后 ， 区 块 链 技术 才 作为 通用 术语 出 现 。 一 个 
区 块 链 是 一 个 分 布 式 计算 架构 , 里 面 的 每 个 网 络 节 点 执行 并 记录 相同 的 交易 , 交 
易 被 分 组 为 区 块 。 一 次 只 能 增加 一 个 区 块 , 每 个 区 块 有 一 个 数学 证 明 来 保证 新 的 
区 块 与 之 前 的 区 块 保持 先后 顺序 。 这 样 一 来 ， 区 块 链 的 “分 布 式 数据 库 ” 就 能 和 
整个 网 络 保持 一 致 。 个 体 用 户 与 总 账 的 互动 (交易 ) 受到 安全 的 密码 保护 。 由 数 
学 执行 并 编码 到 协议 中 的 经 济 激励 因素 刺激 着 维持 和 验证 网 络 的 节点 。 














































































































在 比特 币 中 ， 分 布 式 数据 库 被 设想 为 一 个 账户 余额 表 ， 一 个 总 账 ， 交 易 就 是 通过 
比特 币 的 转移 以 实现 个 体 之 间 无 需 信任 基础 的 金融 活动 ,但 是 随 着 比特 币 吸 引 了 
越 来 越 多 开发 者 和 技术 专家 的 注意 , 新 的 项 目 开始 将 比特 币 网 络 用 于 有 价 代 币 转 
移 之 外 的 其 他 用 途 。 其 中 很 多 都 采用 了 “ 代 币 ”的 形式 一 一 以 原始 比特 币 协 议 为 
基础 ， 增 加 了 新 的 特征 或 功能 ， 采用 各 自 加 密 货币 的 独立 区 块 链 。 在 2013 ER, 
以 大 坊 的 发 明 者 Vitalik Buterin 建议 能 够 通过 程序 重组 来 运行 任意 复杂 运算 的 
单个 区 块 链 应 该 包含 其 他 的 程序 。 




























































































2014 年 ， 以 太 坊 的 创始 人 Vitalik Buterin, Gavin Wood 和 Jeffrey Wilcke 开 
始 研 究 新 一 代 区 块 链 ， 试 图 实现 一 个 总 体 上 完全 无 需 信任 基础 的 智能 合约 平台 。 


1.3 以 太 坊 虚拟 机 
































以 太 坊 是 可 编程 的 区 块 链 。 它 并 不 是 给 用 户 一 系列 预先 设 定好 的 操作 (例如 比特 
币 交 易 ) ， 而 是 允许 用 户 按照 自己 的 意愿 创建 复杂 的 操作 。 这 样 一 来 ， 它 就 可 以 
作为 多 种 类 型 去 中 心 化 区 块 链 应 用 的 平台 ， 包 括 加 密 货 币 在 内 但 并 不 仅 限于 此 。 
































以 大 坊 狭 义 上 是 指 一 系列 定义 去 中 心 化 应 用 平台 的 协议 , 它 的 核心 是 以 太 坊 虚拟 
机 《〈《“EVM”) ， 可 以 执行 任意 复杂 算法 的 编码 。 在 计算 机 科学 术语 中 ， 以 太 坊 
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是 “图 灵 完 备 的 ”。 开 发 者 能 够 使 用 现 有 的 JavaScript 和 Python 等 语言 为 模型 
的 其 他 友好 的 编程 语言 ， 创 建 出 在 以 太 坊 模拟 机 上 运行 的 应 用 。 




















和 其 他 区 块 链 一 样 ， 以 太 坊 也 有 一 个 点 对 点 网 络 协议 。 以 太 坊 区 块 链 数 据 库 由 众 
多 连接 到 网 络 的 节点 来 维护 和 更 新 。 每 个 网 络 节点 都 运行 着 以 太 坊 模拟 机 并 执行 
相同 的 指令 。 因 此 ， 人 们 有 时 形象 地 称 以 太 坊 为 “世界 电脑 ”。 




















这 个 贯穿 整个 以 太 坊 网 络 的 大 规模 并 行 运算 并 不 是 为 了 使 运算 更 高 效 。 实 际 上 ， 
这 个 过 程 使 得 在 以 太 坊 上 的 运算 比 在 传统 “电脑 ”上 更 慢 更 昂贵。 然而 ， 每 个 以 
太 坊 节点 都 运行 着 以 太 坊 虚拟 机 是 为 了 保持 整个 区 块 链 的 一 致 性 去 中 心 化 的 一 
致使 以 太 坊 有 极 高 的 故 隐 容 错 性 ， 保 证 零 停 机 ， 而 且 可 以 使 存储 在 区 块 链 上 的 数 
据 保 持 永 远 不 变 且 抗 审查 。 



































以 太 坊 平台 本 身 没 有 特点 ， 没 有 价值 性 。 和 编程 语言 相似 ， 它 由 企业 家 和 开发 者 
决定 其 用 途 。 不 过 很 明显 ， 某 些 应 用 类 型 较 之 其 他 更 能 从 以 太 坊 的 功能 中 获 益 。 
以 太 坊 尤其 适合 那些 在 点 与 点 之 间 目 动 进行 直接 交互 或 者 跨 网 络 促进 小 组 协调 
活动 的 应 用 。 例如， 协调 点 对 点 市 场 的 应 用 ,或 是 复杂 财务 合同 的 自动 化 。 比 特 
币 使 个 体能 够 不 借助 金融 机 构 、 银 行 或 政府 等 其 他 中 介 来 进行 货币 交换 。 以 太 坊 
I 影响 可 能 更 为 深远 。 理论 上 , 任何 复杂 的 金融 活动 或 交易 都 能 在 以 太 坊 上 用 编 
码 目 动 且 可 靠 地 进行 。 除 金融 类 应 用 外 ,任何 对 信任 、 安 全 和 持久 性 要 求 较 高 的 




















































































































应 用 场景 一 比如 资产 注册 、 投票、 管理 和 物 联网 一 都 会 大 规模 地 受到 以 太 坊 
平台 影响 。 
1.4 以 太 坊 如 何 工作 ? 








以 太 坊 合并 了 很 多 对 比特 币 用 户 来 说 十 分 熟悉 的 特征 和 技术 , 同时 自己 也 进行 了 
很 多 修正 和 创新 。 比 特 币 区 块 链 纯 粹 是 一 个 关于 交易 的 列表 ,而 以 太 坊 的 基础 单 
元 是 账户 。 以 太 坊 区 块 链 跟踪 每 个 账户 的 状态 , 所 有 以 太 坊 区 块 链 上 的 状态 转换 
都 是 账户 之 间 价 值 和 信息 的 转移 。 账 户 分 为 两 类 : 

e 外 部 账户 〈EOA) ， 由 私人 密码 控制 

。 合同 账户 ， 由 它们 的 合同 编码 控制 ， 只 能 由 外 部 账户 “激活 ” 






























































对 于 大 部 分 用 户 来 说 , 两 者 基本 的 区 别 在 于 外 部 账户 是 由 人 类 用 户 掌控 一 一 因为 
他 们 能 够 控制 私 钥 ， 进而 控制 外 部 账户 。 而 合同 账户 则 是 由 内 部 编码 管控 。 如 果 
他 们 是 被 人 类 用 户 “ 控 制 ” 的 ， 那 也 是 因为 程序 设 定 它们 被 具有 特定 地 址 的 外 部 
账户 控制 ， 进 而 被 持 有 私 钥 控制 外 部 账户 的 人 控制 着 。“ 智 能 合约 ”这 个 流行 的 
术语 指 的 是 在 合同 账户 中 编码 一 一 交易 被 发 送 给 该 账户 时 所 运行 的 程序 。 用 户 可 
以 通过 在 区 块 链 中 部 署 编 码 来 创建 新 的 合约 。 







































































只 有 当 外 部 账户 发 出 指令 时 , 合同 账户 才 会 执行 相应 的 操作 。 所 以 合约 账户 不 可 
能 自发 地 执行 诸如 任意 数码 生成 或 应 用 程序 界面 调用 等 操作 一 只 有 受 外 部 账户 
提示 时 ， 它 才 会 做 这 些 事 。 这 是 因为 以 太 坊 要 求 节 点 能 够 与 运算 结果 保持 一 致 ， 
这 就 要 求 保证 严格 确定 执行 。 
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和 比特 币 一 样 ， 以 太 坊 用 户 必 须 向 网 络 文 付 少量 交易 费用 。 这 可 以 使 以 太 坊 区 块 
链 免 受 无 关 紧 要 或 恶意 的 运算 任务 干扰 ， 比 如 分 布 式 拒绝 服务 (DDoS ) 攻击 或 无 
限 循 环 。 交 易 的 发 送 者 必须 在 激活 的 “程序 ”每 一 步 付 款 ， 包 括 运算 和 记忆 储 
存 。 费 用 通过 以 太 坊 日 有 的 有 价 代 币 ， 以 太 币 的 形式 支付 。 












































交易 费用 由 节点 收集 ， 节 点 使 网 络 生效 。 这 些 “ 矿 工 ” 就 是 以 太 坊 网 络 中 收集 、 
传播 、 确 认 和 执行 交易 的 节点 。 夏 工 们 将 交易 分 组 一 包括 许多 以 太 坊 区 块 链 中 
账户 “状态 ”的 更 新 一 一 分 成 的 组 被 称 为 “区 块 ”， 矿 工 们 会 互相 竞争 ， 以 使 他 
们 的 区 块 可 以 添加 到 下 一 个 区 块 链 上 。 矿 工 们 每 挖 到 一 个 成 功 的 区 块 就 会 得 到 以 
太 币 奖励 ,这 就 为 人 们 禹 来 了 经 济 激励 , 促使 人 们 为 以 太 坊 网 络 页 献 便 件 和 电力 。 






















































































和 比特 币 网 络 一 样 , 人 矿工 们 有 解决 复杂 数学 问题 的 任务 以 便 成 功 地 “ 挖 ” 到 区 块 。 
这 被 称 为 “工作 量 证 明 ”。 一 个 运算 问题 ， 如 果 在 算法 上 解决 ， 比 验证 解决 方法 
需要 更 多 数量 级 的 资源 ,那么 它 就 是 工作 证 明 的 极 佳 选择 。 为 防止 比特 币 网 络 中 
已 经 发 生 的 ， 专 门 硬件 (例如 特定 用 途 集成 电路 ) 造成 的 中 心 化 现象 ， 以 太 坊 选 
择 了 难以 存储 的 运算 问题 。 如 果 问 题 需要 存储 器 和 CPU， 事 实 上 理想 的 硬件 是 普 
通 的 电脑 。 这 就 使 以 太 坊 的 工作 量 证 明 具 有 抗 特定 用 途 集成 电路 性 ， 和 比特 币 这 
种 由 专门 硬件 控制 挖 矿 的 区 块 链 相 比 ， 能 够 带 来 更 加 去 中 心 化 的 安全 分 布 。 




















































































































二 章 以 太 坊 账户 管理 
2.1 账户 


账户 在 以 太 坊 中 发 挥 着 中 心 作用 。 共 有 两 种 账户 类 型 ， 外 部 账户 ( EAs) 和合 
约 账户 。 我们 这 里 重点 讲 一 下 外 部 账户 ， 以 下 会 简称 为 斤 户 。 合约 账户 简称 为 他 
£o 产 台 约 葛 六 中 从 1f 论 。 把 外 部 账户 和 合约 账户 都 归 入 到 帐户 的 一 般 概念 是 
合理 的 ， 因 为 这 些 实体 都 是 所 谓 的 汰 驴 和 家 条 。 这 些 实体 都 有 状态 : 账户 有 余额， 
合约 既 有 余额 也 有 合约 储存 。 所 有 账户 的 状态 正 是 以 太 坊 网 络 的 状态 ， 以 太 坊 网 
络 和 每 个 区 块 一 起 更 新 ,网络 需要 达成 关于 以 太 坊 的 共识 。 对 于 用 户 通 过 交易 和 
以 太 坊 区 块 链 互动 来 说 ， 账 户 是 必 不 可 少 的 。 



































如 果 我 们 把 以 太 坊 限制 为 上 内 有 外 部 账户 ,只 允许 外 部 账户 之 间 进 行 交 易 ,我 们 就 
会 进入 到 “ 代 币 ”系统 ，“ 代 币 ” 系 统 不 如 比特 币 本 身 有 力 ， 只 能 用 于 转移 以 大 
币 。 

















账户 代表 着 外 部 代理 人 例如 人 物 角 色 ， 控 矿 节 点 ， 或 是 自动 代理 人 ) 的 身份 。 
账户 运用 公 钥 加 密 图 像 来 签署 交易 以 便 以 太 坊 虚拟 机 可 以 安全 地 验证 交易 发 送 
者 身份 。 
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2.2 钥匙 文件 


每 个 账户 都 由 一 对 钥匙 定义 ， 一 个 私 钥 和 一 个 公 钥 。 账户 以 地 址 为 索引 ， 地 址 
由 公 钥 衍生 而 来 ， 取 公 钥 的 最 后 20 个 学 节 。 每 对 私 钥 /地 址 都 编码 在 一 个 幼 粥 
KHE. RESCUE JSO 文本 文件 ， 可 以 用 任何 文本 编辑 器 打开 和 浏览 。 钥 是 
文件 的 关键 部 分 ， 账户 私 钥 ，, 通常 用 你 创建 帐户 时 设置 的 密码 进行 加 密 。 钥 匙 文 
件 可 以 在 以 太 坊 节点 数据 目录 的 keystore 子 目 录 下 找到 。 确 保 经 常 给 钥匙 文件 
备份 ! fut Ee PIA EAT DP ESSA. AEH EMA EIKA ZE— REI. 
"不 必 告 诉 任何 人 你 的 操作 。 

* 不必 和 区 块 链 同 步 。 

"不 必 运 行 客 户 端 。 

。 其 至 不 必 连 接 到 网 络 。 

当然 新 账户 不 包含 任何 以 太 币 。 但 它 将 会 是 你 的 ， 你 大 可 放心 ,没有 你 的 钥 是 和 
密码 ， 没 有 人 能 进入 。 

转换 整个 目录 或 任何 以 太 坊 厄 点 之 间 的 个 人 钥匙 文件 都 是 安全 的 。 

警告， 请 注意 万 一 你 从 一 个 不 同 的 节点 向 另 一 个 节点 添加 钥匙 文件 ， 账户 的 顺 
序 可 能 发 生 改 变 。 确 保 不 要 回复 或 改变 手稿 中 的 索引 或 代码 片段 。 













































































2.3 创建 账号 


Ak. 记 住 密码 并 “备份 钥匙 文件 backup-and-restore-accounts>”。 为 了 从 账号 
AGE E. 包括 发 送 以 太 币 ， 你 必须 同时 有 钥匙 文件 和 密码 。 确 保 钥匙 文件 有 个 备份 
并 牢记 密码 ， 尽 可 能 安全 地 存储 它们 。 这 里 没有 逃亡 路 径 ， 如 果 钥 匙 文件 丢失 或 筷 记 
密码 ， 就 会 丢失 所 有 的 以 太 币 。 没 有 密码 不 可 能 进入 账号 ， 也 没有 否 妇 符 移 选项 。 所 
以 一 定 不 要 忘记 密码 。 









































使 用 geth account new 








一 旦 安装 了 geth 客户 端 ， 创 建 账号 就 只 是 在 终端 执行 geth account new 指令 
的 问题 了 。 














注意 不 必 运 行 geth 客户 端 或 者 和 区 块 链 同步 来 使 用 geth account 指令 。 





$ geth account new 


Your new account is locked with a password. Please give a password. Do 
not forget this password. 


Passphrase: 
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Repeat Passphrase: 


Address: [168bc315a2ee090424834d7c5811b533620531f67] 

















对 于 非 交 互 式 使 用 ， 你 可 以 提供 纯 文 本 密码 文件 作为 一 password 标志 的 变 元 。 
文件 中 的 数据 包含 密码 的 原始 字 节 ， 后 面 可 选择 单独 跟着 新 的 一 行 。 





$ geth —password /path/to/password account new 





警告 : 用 --password 标志 只 是 为 了 测试 或 在 信任 的 环境 中 目 动 操作 。 不 建议 将 密码 
保存 在 文件 中 或 以 任何 其 他 方式 暴露 。 如 果 你 用 密码 文件 来 使 用 --password 标志 ， 
要 确保 文件 只 对 你 自己 可 阅读 和 列表 。 你 可 以 在 Mac/Linux 系统 中 通过 以 下 指令 实 
F: 


























touch /path/to/password 
chmod 600 /path/to/password 
cat > /path/to/password 


>I type my pass 








要 列 出 目前 在 你 的 keystore 文件 夹 中 的 钥匙 文件 的 所 有 账号 ， 使 用 geth 


account 指令 的 list 子 指令 : 

$ geth account list 

account #0: [a94f5374fcebedbc8e2a8697c15331677e6ebf0bj] 
account #1: [c385233b188811c9f355d4caec14df864d6248235] 
account 82: (7f444580bfef4b9bc7el4eb7fb2a029336b07c9d] 


钥匙 文件 的 文件 名 格式 为 UTC--<created at UTC IS08601»-«address hex». Ji 
号 列 出 时 是 按 字母 顺序 排列 , 但 是 由 于 时 间 戳 格式 , 实际 上 它 是 按 创建 顺序 排列 。 








使 用 geth 控制 台 





为 了 用 geth 创建 新 账号 , 我 们 必须 先 在 控制 台 模 式 开 启 geth (或 者 可 以 用 geth 
attach 将 控制 台 依 附 在 已 经 运行 着 的 事例 上 ) : 








> geth console 2>> file to log output 
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instance: Geth/vl. 4. 0-unstable/linux/gol. 5. 1 
coinbase: coinbase: [object Object] 
at block: 865174 (Mon, 18 Jan 2016 02:58:53 GMT) 


datadir: /home/USERNAME/. ethereum 





控制 台 使 你 能 够 通过 发 出 指令 与 本 地 节点 互相 作用 。 比 如 ， 试 一 下 这 个 列 出 账号 
的 指令 : 


> eth. accounts 


{ 
code: -32000, 
message: ^no keys in store” 


} 





这 就 表明 你 没有 账号 。 你 也 可 以 从 控制 台 创 建 一 个 账号 : 





> personal. newAccount () 
Passphrase: 
Repeat passphrase: 


“0xb2f69ddf70297958e582a0cc98bce43294f1007d” 


注意 : 记得 用 一 个 安全 性 强 、 随 机 生成 的 密码 。 








我 们 刚刚 创建 了 第 一 个 账号 。 如 果 我 们 再 次 试 着 列 出 账号 ， 就 可 以 看 到 新 创建 的 
账号 了 。 





> eth. accounts 


["^0xb2f69ddf70297958e582a0cc98bce43294f10074" ] 


使 用 Mist 以 太 坊 钱包 
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对 于 相反 的 命令 行 , 现在 有 一 个 基于 GUI 的 选项 可 以 用 来 创建 账号 :“ 官 方 ”Mist 
以 太 坊 钱包 。 Mist 以 太 坊 钱包 ， 和 它 的 父 项 目 Mist， 是 在 以 太 坊 基金 会 的 赞助 
下 开发 ， 因 此 是 “官方 ”地 位 。 钱 包 应 用 有 Linux, Mac 0S XJI Windows 可 用 的 
版 本 。 





























警告; Mist 钱包 是 试用 软件 ， 使 用 需 风 险 自 担 。 








用 GUI Mist 以 太 坊 钱包 创建 账号 再 容易 不 过 了 。 事 实 上 ， 第 一 个 账号 在 应 用 安 
装 期 间 就 创建 出 来 了 。 





Ne 














1. 根据 你 的 操作 程序 下 载 钱 包 应 用 最 新 版 本 。 由 于 你 实际 上 会 运行 一 个 完整 的 
geth 节点 ， 打 开 钱 包 应 用 就 会 开始 同步 复制 你 电脑 上 的 整个 以 太 坊 区 块 链 。 








2. 解锁 下 载 的 文件 来， 运行 以 太 坊 钱包 可 执行 文件 。 











3， 等待 区 块 链 完全 同步 ， 按 照 屏 幕 上 的 说 明 操 作 ， 第 一 个 账号 就 创建 出 来 了 。 











4. 第 一 次 登录 Mist 以 太 坊 钱包 ， 你 会 看 到 自己 在 安装 过 程 中 创建 的 账号 。 它 
会 被 默认 命名 为 主 账号 (以 大 库 ) 

5， 再 另外 创建 账号 很 容易 ， 只 需 点 击 应 用 主 界面 上 的 添加 账号 ， 输 入 所 需 的 密 
码 即 可 。 











注意 : Mist 钱包 仍 在 开发 中 ， 以 上 列 出 的 具体 步骤 可 能 会 随 着 更 新 有 所 变更 。 





第 三 章 更 新 、 备 份 、 恢 复 账号 


3.1 更 新 账号 





你 可 以 把 钥匙 文件 更 新 到 最 新 的 钥匙 文件 格式 并 且 / 或 者 升级 钥匙 文件 密码 。 








使 用 geth 
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你 可 以 在 命令 行 用 更 新 子 命令 更 新 现在 的 账号 , 可 以 使 用 账号 地 址 或 者 索引 作为 
参数 。 记 住 账号 索引 反映 了 创建 顺序 〈 按 字母 顺序 排列 的 钥匙 文件 名 包含 了 创建 
IRI) 。 




















geth account update b0047c606f3af7392e073ed13253f8f4710b08b6 
或 者 

geth account update 2 

例如 : 


$ geth account update a94f5374fce5edbc8e2a8697c15331677e6ebf0b 
Unlocking account a94f5374fce5edbc8e2a8697c15331677e6ebf0b | Attempt 
1/3 

Passphrase: 

0xa94f5374fcebedbc8e2a8697c15331677e6ebfOb 

account 'a94f5374fcebedbc8e2a8697c15331677e6ebfO0b' unlocked. 

Please give a new password. Do not forget this password. 

Passphrase: 

Repeat Passphrase: 

0xa94f5374fcebedbc8e2a8697c153316777e6ebfOb 








on. 的 形式 储存 在 最 新 版 本 ， 它 会 提示 你 需要 一 个 密码 来 解锁 账户 ,， 另 一 
密码 来 保存 更 新 的 文件 ,同一 个 指令 > 还 可 以 用 在 将 弃 用 格式 的 账户 变 成 最 新 版 

Se 

对 于 非 交 互 式 使 用 ， 密 码 可 以 用 一 password 标志 详细 说 明 : 

















geth --password Xpasswordfile? account update 
a94f5374fcebedbc8e2a8697c15331677e6ebfÜObs 








给 出 一 个 密码 , 所 以 只 能 执行 格式 更 新 , 修改 密码 只 在 交互 式 的 情况 下 





























注意 : 账号 更 新 有 个 副作用 就 是 会 引起 账号 顺序 变化 。 更 新 成 功 后 ， 同 一 钥匙 所 
有 之 前 的 格式 /版 本 都 会 被 移 除 ! 











3.2 账号 备份 和 恢复 
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手动 备份 /恢复 











要 从 账号 发 送 交 易 , 需要 有 账号 钥匙 文件 。 钥匙 文件 可 以 在 以 太 坊 节点 数据 目录 
的 钥匙 商店 (keystore) 子 目录 下 找到 。 默 认 数 据 目录 的 位 置 与 平台 相关 : 

* Windows: C:\Users\username\%appdata%\Roaming\Ethereum\keystore 

e Linux: /.ethereum/keystore 

e Mac: /Library/Ethereum/keystore 














要 备份 钥匙 文件 〈 账 号 ) ， 在 keystore 子 目录 中 复制 单独 的 钥匙 文件 或 复制 整 
^* keystore 文件 夹 。 





要 恢复 钥匙 文件 (账号 ) ， 将 钥匙 文件 重新 复制 到 keystore 子 目 录 ， 即 其 原始 
地 址 。 





导入 未 加 密 私 钥 


导入 未 加 密 私 钥 由 geth 支持 
geth account import /path/to/<keyfile> 





这 个 指令 从 纯 文本 文件 <keyfile> 导 入 未 加 密 私 钥 并 创建 新 账号 和 打印 地 址 。 钥 
匙 文件 被 假定 包含 未 加 密 私 钥 作 为 编码 到 十 六 进 制 的 标准 EC 原始 字 节 。 账 号 以 
加 密 的 形式 储存 ， 会 提示 你 输入 密码 。 你 需要 记 住 密码 用 于 以 后 解锁 账号 。 














下 面 给 出 一 个 例子 ， 详 细 说 明 数 据 目录 。 如 果 一 datadir 标志 没有 使 用 ， 新 账 
户 就 会 被 创建 在 默认 数据 目录 里 ,例如 钥匙 文件 会 被 放 在 数据 目录 的 钥匙 文件 子 
目录 里 。 











$ geth --datadir /someOtherEthDataDir account import ./key.prv 
The new account will be encrypted with a passphrase. 

Please enter a passphrase now. 

Passphrase: 

Repeat Passphrase: 

Address: (Tf444580bfef4b9bc7el4eb7fb2a029336b07c9d] 











对 于 非 交 互 式 使 用 ， 密 码 可 以 用 —password 标志 详细 说 明 : 


geth —password <passwordfile account import 《keyfile> 








注意 : 因为 你 可 以 直接 把 加 密 账户 复制 到 男 一 个 以 太 坊 事 例 中 , 在 节点 之 间 转 移 
账号 的 时 候 就 不 需要 这 个 导入 /导出 机 制 了 。 
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当 你 往 已 存在 节点 的 keystore 里 复制 钥匙 的 时 候 ， 你 习惯 的 账户 顺序 可 


























能 会 


ee 


第 四 章 公有 链 、 联 盟 链 、 私 有 链 和 网 络 


4.1 以 太 坊 网 络 











去 中 心 化 共识 的 基础 是 参与 节点 的 点 对 点 网 络 , 节点 维持 和 保护 着 区 块 链 (维护 
并 保证 区 块 链 网 络 的 安全 ) . ALIE. 


以 太 坊 网 络 数 据 




















EthStats. net 是 以 太 坊 网 络 实 时 数据 的 仪表 板 ， 这 个 仪表 板 展示 重要 信息 ， 诸 
如 现在 的 区 块 ， 散 表 难 度 ，gas 价格 和 gas 花费 等 。 页 面 上 显示 的 节点 只 是 精 选 
了 网 络 上 的 实际 节点 。 任 何人 都 可 以 在 EthStats 仪表 板 上 添加 他 们 的 节点 。 
Github 上 的 Eth-Netstats README 描述 了 如 何 连 接 。 


























EtherNodes. com 展示 了 市 点 数 的 当前 和 历史 数据 以 及 以 太 坊 主 网 络 和 Morden W 
试 网 络 上 的 其 他 信息 。 























J 问 实 现 分 配 - EtherChain 上 的 实时 数据 。 


4.2 公有 链 、 私 有 链 和 联盟 链 








当今 大 多 数 以 太 坊 项 目 都 依靠 以 太 坊 作为 公有 链 ， 公 有 链 可 以 访问 到 更 多 用 户 ， 
网 络 节点 ,货币 和 市 场 。 然 而 通 第 有 理由 更 偏好 私有 链 或 联盟 链 (在 一 群 值得 信 
任 的 参与 者 中 ) 。 例 如 ， 银 行 领域 的 很 多 公司 都 希望 以 太 坊 作为 他 们 私有 链 的 平 


人 
Lo 






































以 下 是 博客 发 文 《关于 公有 链 和 私有 链 》 的 摘录 ， 它 解释 了 三 种 区 块 链 在 许可 方 
面 的 区 别 : 

















。 公 有 链 : 世界 上 所 有 人 都 可 以 阅读 和 发 送 交 易 。 如 果 他 们 合法 都 有 希望 看 到 目 
己 被 包括 在 内 。 世 界 上 任何 人 都 能 参与 到 共识 形成 过 程 一 决定 在 链条 上 添加 什 
么 区 块 以 及 现状 是 怎样 的 。 作 为 中 心 化 或 准 中 心 化 信任 的 蔡 代 品 , 公有 链 受 加 密 
经 济 的 保护 ， 加 密 经 济 是 经 济 激励 和 加 密 图 形 验 证 的 结合 , 用 类 似 工 作 量 证 明 或 
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权益 证 明 的 机 制 , 遵循 的 总 原则 是 人 们 影响 共识 形成 的 程度 和 他 们 能 够 影响 的 经 
济 资 源 数 量 成 正比 。 这 类 区 块 链 通常 被 认为 是 “完全 去 中 心 化 “。 








”联盟 链 ， 共识 形成 过 程 由 预先 选择 的 一 系列 的 节点 所 掌控 例如， 设想 一 个 有 
15 个 金融 机 构 的 团体 ， 每 个 机 构 都 操作 一 个 节点 ， 为 了 使 区 块 生效 ， 其 中 的 10 
个 必须 签署 那个 区 块 。 阅 读 区 块 链 的 权利 可 能 是 公开 的 ， 或 仅 限于 参与 者 ， 也 有 
混合 的 路 径 ， 比 如 区 块 的 根 散 表 和 应 用 程序 编程 接口 一 起 公开 ， 使 公共 成 员 可 以 
进行 一 定量 的 查询 , 重 获 一 部 分 区 块 链 状态 的 加 密 图 形 证 明 。 这 类 区 块 链 被 认为 
是 “部 分 去 中 心 化 ”。 


。 私 有 链 : 书写 许可 对 一 个 组 织 保持 中 心 化 。 阅读 许可 可 能 是 公开 的 或 者 限制 在 
任意 程度 。 应 用 很 可 能 包含 对 单个 公司 内 部 的 数据 库 管 理 ， 审 但 等 ， 因 此 公共 的 
可 读 性 在 很 多 情况 下 根本 不 必要 ， 但 在 为 一 些 情况 下 人 们 又 想 要 公共 可 读 性 。 


私有 链 /联盟 链 可 能 和 公有 和 链 喀 无 联系 ， 他 们 仍然 通过 投资 以 太 坊 软件 开发 ， 对 


以 太 坊 整 体 生态 系统 有 利 。 经 过 一 段 时 间 ， 这 会 转变 成 软件 改善 ， 知识 共享 和 工 
作 机 会 。 


4.3 如 何 连 接 















































m 

















Geth 会 持续 尝试 在 网 络 上 连接 到 其 他 节点 ， 直 到 有 了 端点 为 止 。 如 果 你 在 路 由 
器 上 有 可 用 的 UPnP 或 者 在 面向 因特网 的 服务 器 上 运行 以 太 坊 ， 它 也 会 接受 其 他 
节点 的 连接 。 





Geth 通过 发 现 矿 攻 找 到 对 等 端 。 在 发 现 协 议 中 ， 节 点 互相 闲聊 发 现 网 络 上 的 其 
他 节点 。 最 开始 ，geth 会 使 用 一 系列 辅助 程序 节点 ， 这 些 辅助 程序 节点 的 端点 
记录 在 源 代码 中 。 


检查 连接 和 ENODE 身份 


要 检查 客户 端 在 交互 控制 全 上 连接 了 多 少 对 等 端点 ，net 模块 有 两 个 属性 可 以 提 
供 信 息 ， 告 诉 你 对 等 端点 的 数量 以 及 你 是 否 在 监听 的 节点 。 



































> net. listening 
true 

? net. peerCount 
4 


了 解 更 多 关于 连接 对 等 端点 的 信息 ， 比 如 IP 地 址 、 端 口号 和 文 持 协议 ， 用 管理 
员 对 象 的 peers () 功能 。admin. peers O 会 返回 到 现在 已 连接 的 对 等 端点 列表 。 














> admin. peers 
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[1 

ID: 

' a4de274d3a159e10c2c9a68c326511236381b84c9ec52e72ad132eb0b2b1a2271938 
f78593cdbe734e6002bf23114d43420854d260514ab336d4acdc312db671b' , 

Name: 'Geth/v0. 9. 14/linux/gol.4.2', 

Caps: 'eth/60', 

RemoteAddress: '5.9.150.40:30301', 

LocalAddress: '192.168.0.28:39219' 

hoc 

ID: 

' a979fb575495b8d6db44f750317d0f£4622bf4c2aa3365d6af 7c284339968eef29b69 
ad0dce72a4d8db5ebb4968de0e3bec910127£134779fbcb0cb6d3331163c' , 

Name: 'Geth/v0. 9. 15/1inux/gol.4.2', 

Caps: 'eth/60', 

RemoteAddress: '52.16.188.185:30303', 

LocalAddress: '192.168.0.28:50995' 

h. 1 

ID: 

' f6balfid9241448138136ccf5baa6c2c8b008435alc2bd009ca52fb8edbbc991eba3 
6376beaee9d45f16d5dcbf2ed0bc23006c505d57ffcf70921bd94aa7a172' , 

Name: 'pyethapp dd52/v0.9. 13/linux2/py2. 7. 9' , 

Caps: 'eth/60, p2p/3', 

RemoteAddress: ' 144. 76.62. 101:30303', 

LocalAddress: '192.168.0.28:40454' 

}, 

ID: 

' f4642fa65af50cfdea8fa7414a5def7bb7991478b768e296f5e4a54e8b995de102e0 
ceae2e826f293c481b5325f89be64d207b003382e18a8ecba66fbaf6416c0' , 

Name: ' teth/Zeppelin/Rascal/v0. 9. 14/Release/Darwin/clang/int', 

Caps: 'eth/60, shh/2', 

RemoteAddress: '129.16.191.64:30303', 

LocalAddress: '192.168.0.28:39705' 

} ] 








要 检查 geth 使 用 的 端口 ， 发 现 你 自己 的 enode URI 执行 : 


> admin. nodeInfo 

Name: “Geth/v0. 9. 14/darwin/gol. 4. 2' , 

NodeUrl: 

' enode: //3414c01c19aa75a34f2dbd2f840898dc 79d6b219ad77£8155abf1a287ce2 
ba60f14998a3a98c0cf14915eabfdacf914a92b27a01769de18fa2d049dbf4c176940 
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[::]:30303’， 

NodeID: 

' 3414c01c19aa75a34f2dbd2f8d0898dc79d6b219ad77f8155abf1a2877ce2ba60f149 
98a3a98c0cf14915eabfdacf914a92b27a01769de18fa2d049dbf4c17694' , 

pe se 

DiscPort: 30303, 

TCPPort: 30303, 

Td: '2044952618444' , 

ListenAddr: " [31230909 

} 


4.4 更 快 下 载 区 块 链 


BAARIA mT, 会 自动 下 载 以 太 坊 区 块 链 。 用 于 下 载 以 太 坊 区 块 链 的 时 间 
会 根据 客户 端 、 客 户 端 设置 、 连 接 速度 和 可 用 的 端点 数量 变化 。 下 面 是 更 快 获取 
以 太 坊 区 块 链 的 一 些 选 项 。 














使 用 geth 
如 果 你 在 用 geth 客户 端 ， 你 可 以 做 些 什么 来 加 速 下 载 以 太 坊 区 块 的 时 间 。 如 果 
你 用 一 fast 标志 来 执行 以 太 坊 快速 同步 ， 不 会 保留 过 去 的 交易 数据 。 














注意 : 你 不 能 在 执行 所 有 或 者 部 分 正常 的 同步 操作 之 后 再 使 用 这 个 标志 ,也 就 是 
说 在 用 这 个 指令 之 前 ， 不 能 下 载 以 太 坊 区 块 链 的 任何 部 分 。 查 看 这 个 Ethereum 
Stack. Exchange answer 了 解 更 多 。 














下面 是 想 要 更 快 同步 客户 端 时 使 用 的 一 些 标 志 。 





—fast 

这 个 标志 使 通过 状态 下 载 而 不 是 下 载 整 个 区 块 数据 来 实现 快速 同步 成 为 可 能 。 记 
样 也 能 大 幅 减 少 区 块 链 尺 寸 。 注 意 : 一 fast 只 在 从 头 开 始 同步 区 块 链 ， 并 且 是 
出 于 安全 原因 第 一 次 下 载 区 块 链 时 ， 才 会 运行 。 查 看 Reddit 发 文 了 解 更 多 。 




















—cache-1024 
分 配 到 内 部 缓存 的 千 兆 内 存 〈 最 少 16MB / 数据 库 ) 。 默 认 是 16MB， 所 以 根据 
你 电脑 内 存 多 少 ， 增 加 到 256，512，1024 (1GB) 或 者 2048 (2GB) 会 带 来 不 同 。 








—-jitvm 
这 个 标志 可 以 激活 JIT VM. 
完整 的 控制 台 命 令 示 例 : 
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geth --fast —-cache-1024 --jitvm console 





了 解 更 多 关于 快速 同步 和 区 块 链 下载 次 数 的 讨论 ， 碍 看 这 篇 Reddit 发 文 。 








导出 /导入 区 块 链 

如 果 你 已 经 同步 了 整个 以 太 坊 节点 , 可 以 从 完全 同步 的 节点 中 导出 区 块 链 数据 并 
将 其 导入 新 节点 。 你 可 以 在 geth 中 用 geth export filename 指令 导出 所 有 节点 ， 
并 用 geth import filename 将 区 块 链 导入 节点 ， 来 实现 这 一 目的 。 











4.5 静态 节点 ， 信 任 节点 和 启动 节 扣 


Geth 支持 一 个 叫 静 态 节 点 的 特征 ， 如 果 你 有 特定 的 端点 ， 你 会 一 直 想 与 静态 节 
点 连接 。 如 果断 开 连 接 ， 静 态 节 点 会 再 次 连接 。 你 可 以 配置 永久 性 静态 节点 ， 方 
法 是 将 如 下 所 说 的 放 进 《datadir>/static-nodes. json (这 应 该 是 和 chaindata 
以 及 keystone 在 同一 个 文件 夹 ) 
































[ 
“enode://f4642fa65af50cfdea8fa7414a5def7bb7991478b768e296f5e4a54e8b99 
5del02e0ceae2e826f293c481b5325f89be6d207b003382el8a8ecba66fbaf6416c0@ 
33. 4. 2. 1:30303”, 

”enode://pubkey@ip:port” 


] 








你 也 可 以 在 运行 期 间 通 过 Javascript 使 用 admin. addPeer 0) 加 入 静态 节点 。 


> 
admin. addPeer ("enode://f4642fa65af50cfdea8fa7414abdef7bb7991478b768e2 
96f5e4a5b4e8b995de102e0ceae 


连接 的 常见 问题 











有 时候 可 能 无 法 连接 ， 最 常见 的 原因 有 : 
。 本 地 时 间 不 正确 。 要 参与 到 以 太 坊 网 络 中 ， 需 要 精确 的 时 钟 。 检 查 OS 
如 何 同 步 时 钟 〈 例 如 sudo ntpdate -s time. nist. gov) ， 即 便 只 快 了 12$ 
有 可 能 导致 0 端点 。 
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。 有 的 防火 墙 配 置 可 能 会 阻止 UDP 流通 。 可 以 用 项 态 节点 功能 或 者 控制 台 
上 的 admin. addPeer () 来 手动 配置 连接 。 








不 使 用 发 现 协议 来 启动 geth， 你 可 以 用 一 nodiscover 参数 。 你 只 会 在 运行 测试 
节点 或 有 固定 节点 的 实验 测试 网 络 时 才 想 要 这 样 做 。 














第 五 章 搭建 测试 网 络 和 私有 链 


5.1 Morden 测试 网 


Morden 是 公开 的 以 太 坊 奉 代 测试 网 。 它 会 贯穿 于 整个 软件 里 程 碑 Frontier 和 
Homestead. 


用 法 





eth (C++ 客 户 端 ) 0.9.93 及 以 上 版 本 自动 支持 。 比 如 开启 以 下 任意 客户 端 时 ， 
通过 一 morden 参数 。 





PyEthApp (Python 客户 端 ) PyEthApp 支持 v1. 0. 5 以 后 的 morden 网 络 。 
geth (Go 客户 端 ) 
细节 





除 以 下 几 条 ， 所 有 参数 都 和 主要 的 以 太 坊 网 络 相 同 : 
。 网 络 名 称 : Morden 
网 络 身 份 : 2 
e genesis. json (如 下 ) ; 
。 初始 账户 随机 数 CIAN) 是 2 20 (不 像 之 前 的 网 络 中 是 0) 

- 状态 树 形 结构 中 的 所 有 账户 都 有 随机 数 >= IAN. 

- 账户 被 插入 到 状态 树 形 结构 中 时 ， 都 会 被 赋予 一 个 初始 随机 数 = IAN. 
。 初始 通用 区 块 散 表 : 
0cd786a2425d16f152c658316c423e6ce1181e15c3295826d'7c9904cba9ce303 
* 初始 通用 状态 根 : 
f3f4696bbf3b3b07775128eb7a3763279a394e382130f27c21e70233e04946a9 




















Morden 的 genesis. json 


获取 Morden 测试 网 以 太 币 
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有 两 种 方法 可 以 获取 Morden 测试 网 以 太 币 : 
。 用 CPU/GPUTA2S. CEMT 。 
。 用 以 太 坊 wei 龙头 。 





5.2 设置 本 地 私有 测试 网 


eth (C++ 客户 端 ) 








可 以 使 用 - genesis 和 - config 连接 到 或 创建 一 个 新 的 网 络 。 








可 以 同时 使 用 -config 和 - genesis. 














那样 的 话 ， - config 提供 的 初始 区 块 描述 会 被 - genesis 选项 覆盖 。 





注意 : 《filename> 包 含 一 个 网 络 的 JSON 描述 。 





e sealEngine (用 来 在 区 块 控 矿 的 引擎 ) 
“Ethash” 是 以 太 坊 工作 量 证 明 引 擎 (用 于 实时 网 络 ) 。 
“NoProof ” 在 区 块 挖 矿 不 需要 工作 量 。 
e params (诸如 minGasLimit, minimumDifficulty, blockReward, networkID 
等 一 般 的 网 络 信息 ) 
。 genesis (初始 区 块 描述 ) 
* accounts (设置 包含 账户 /合约 的 初始 状态 ) 






































这 是 一 个 Config 的 例子 (用 于 Olympic 网 络 ) : 


注意 : 《filename> 包 含 一 个 网 络 的 JSON 描述 。 





内 容 与 ，config” 参 数 提供 的 初始 领域 相同 。 


geth (Go 客户 端 ) 





你 可 以 在 私有 测试 网 上 生成 或 挖掘 自己 的 以 太 币 。 这 个 试验 以 太 坊 方法 很 划算 ， 
可 以 避免 不 得 不 挖 矿 ， 或 找到 Morden 测试 网 络 的 以 太 币 。 








在 私有 和 链 中 需要 详细 说 明 的 事件 有 : 
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”定制 初始 文件 
。 定制 数据 目录 
* 定制 网 络 ID 
(推荐 ) 废弃 节点 发 现 





初始 文件 


初始 区 块 是 区 块 链 的 起 始 一 第 一 个 区 块 ， 区 块 0， 唯 一 没有 指向 前 面 区 块 的 一 
个 区 块 。 协 议 确保 其 他 节点 不 会 和 你 的 区 块 链 一 致 ， 除 非 他 们 和 你 有 相同 的 初始 
区 块 ， 这 样 你 想 创建 多 少 私 有 测试 网 区 块 链 ， 就 可 以 创建 多 少 ! 











{ 

“nonce”: “0x0000000000000042”, “timestamp”: ^0x0^, 

“parentHash”: 
”0x0000000000000000000000000000000000000000000000000000000000000000”, 
"extraData": “0x0”, ”gasLimit”: ”0x8000000”, ”difficulty”: ^0x400^, 
^mixhash": 
^0x0000000000000000000000000000000000000000000000000000000000000000^, 
”coinbase”: ”0x3333333333333333333333333333333333333333”, ”alloc”: 1 ] 
} 





存储 文件 为 CustomGenesis. json。 用 下 面 的 标志 启动 geth 节点 的 时 候 ， 你 会 引 
用 到 这 个 。 


—-genesis /path/to/CustomGenesis. json 


私有 网 络 的 命令 行 参 数 














有 一 些 必需 的 命令 行 选项 (又 称 为 “标志 ”) 来 确保 你 的 网 络 是 私有 的 。 我 们 已 
经 谈 到 了 初始 标志 ， 下 面 还 有 儿 个 。 注 意 所 有 下 面 的 指令 都 会 用 在 geth 以 太 坊 
客户 端 。 

















—-nodiscover 
使 用 这 个 命令 可 以 确保 你 的 节点 不 会 被 非 手动 添加 你 的 人 发 现 。 和 否则 ,你 的 节点 
可 能 被 陌生 人 的 区 块 链 无 意 添 加 ， 如 果 他 和 你 有 相同 的 初始 文件 和 网 络 ID。 








——maxpeers 0 
如 果 你 不 希望 其 他 人 连接 到 你 的 测试 链 ， 可 以 使 用 maxpeers 0。 反 之 ， 如 果 你 
确切 知道 希望 多 少 人 连接 到 你 的 节点 ， 你 也 可 以 通过 调整 数字 来 实现 。 




















-DC 


这 个 指令 可 以 激活 你 节点 上 的 RPC 界面 。 它 在 geth 中 通常 被 默认 激活 。 
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—rpcapi "db, eth, net, web3^ 
这 个 命令 可 以 决定 允许 什么 API 通过 RPC 进入 。 在 默认 情况 下 ， geth 可 以 在 RPC 
激活 web3 界面 。 





重要 信息 : 请 注意 在 RPC/IPC 界面 提供 API， 会 使 每 个 可 以 进入 这 个 界面 〈 例 如 
dapp”s) 的 人 都 有 权限 访问 这 个 API。 注 意 你 激活 的 是 哪个 API。Geth 会 默认 
激活 IPC 界面 上 所 有 的 API， 以 及 RPC 界面 上 的 db, eth, net 和 web3 API. 


—rpcport ^8080^ 
将 8000 改变 为 你 网 络 上 开放 的 任何 端口 。Geth 的 默认 设置 是 8080. 





—rpccorsdomain “http://chriseth. github. io/browser-solidity/^ 

这 个 可 以 指示 什么 URL 能 连接 到 你 的 节点 来 执行 RPC 定制 端 任务 。 务 必 谨 慎 ， 输 
入 一 个 特定 的 URL 而 不 是 wildcard (*)， 后 者 会 使 所 有 的 URL. 都 能 连接 到 你 的 
RPC 实例 。 











—datadir "/home/TestChainl^ 
这 是 你 的 私有 链 数据 所 储存 在 的 数据 目录 (在 nubits F) 。 选 择 一 个 与 你 以 太 
坊 公 有 和 链 文 件 夹 分 开 的 位 置 。 





——identity “TestnetMainNode” 
这 会 为 你 的 节点 设置 一 个 身份 , 使 之 更 容易 在 端点 列表 中 被 辨认 出 来 。 这 个 例子 
说 明了 这 些 身份 如 何在 网 络 上 出 现 。 

















发 布 geth 








你 创建 了 定制 初始 区 块 JSON 并 建立 区 块 链 数据 目录 后 , 在 控制 台 输入 以 下 指令 ， 
进入 geth: 


geth —identity “MyNodeName” --genesis /path/to/CustomGenesis. json —-rpc 


—rpcport ^8080" —-rpcco 


注意 : 请 改变 标志 与 定制 设置 匹配 。 





每 次 想 要 进入 定制 链 的 时 候 ， 你 都 需要 用 定制 链 指令 局 动 geth 实例 。 如 果 你 只 
在 控制 台 输 入 “geth”， 它 不 会 记 住 你 设置 的 所 有 标志 。 








给 账户 预 分 配 以 太 币 
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“0x400” 难 度 能 让 你 再 私有 测试 网 链 上 快速 挖 以 太 币 。 如 果 你 创建 了 自己 的 链 ， 
开始 挖 矿 ， 你 应 该 几 分 钟 就 会 有 上 百 个 以 太 币 , 远 远 超过 了 在 网 络 上 测试 交易 所 
需 的 数量 。 如 果 你 还 想 给 账户 预 分 配 以 太 币 ， 就 需要 : 















































1. 创建 私有 链 以 后 再 创建 新 的 以 太 坊 账户 。 
2- 复制 新 的 账户 地 址 。 
3. 在 Custom Genesis. json 文件 中 添加 以 下 指令 











“alloc”: 


{ 

”<your account address e.g. 0xlfb891f92eb557f4d688463d0d7c560552263b5a>”: 
{ "balance": ^20000000000000000000" } 

} 


注意 : 用 你 的 账户 地 址 取代 0x1fb891f92eb557f4d688463d0 
d7c560552263b5a 








保存 初始 文件 ， 重 新 运行 私有 链 指令 。Geth 完整 装载 以 后 ， 关 闭 它 。 











我 们 想 指 派 一 个 地 址 给 变量 primary, AF CRK. 








在 终端 运行 geth account list 指令 ， 查 看 指派 给 你 的 新 地 址 账户 号 码 是 什么 。 








> geth account list 

Account #0: {dlade25ccd3d550a7eb532ac759cac7be09c2719 
Account #1: {da65665fc30803cblfb7e6d86691e20b1826dee0 
Account #2: {e470bla7d2c9c5c6f03bbaa8fa20db6d404a0c32 
Account #3: {f4dd5c3794f1fd0cdc0327a83aa472609c806e99 


一 一 一 一 一 一 一 一 














记录 你 预 分 配 以 太 币 的 账户 号 码 。 或 者 , 可 以 用 geth console (和 最 先 启动 geth 
时 保持 一 样 的 参数 ) 局 动 控 制 台 。 提 示 出 现 以 后 ， 输 入 


> eth. accounts 








会 返回 到 你 拥有 的 账户 地 址 排列 。 


> primary = eth. accounts [0] 





注意 : 用 你 的 账户 指数 取代 0， 这 个 控制 台 指 令 会 返回 到 你 第 一 个 以 太 坊 地 址 。 
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输入 以 下 指令 : 


> balance = web3. fromWei (eth. getBalance (primary), “ether”); 


这 应 该 会 返回 到 7. 5， 意 味 着 你 账户 里 有 那么 多 以 太 币 。 我 们 必须 在 你 初始 文件 
的 分 区 里 放 那 么 多 数量 是 因为 “余额 ”领域 以 wei 为 单位 取 一 个 数字 ，wei 是 以 
太 坊 货币 以 太 币 的 最 小 面额 〈 参 见 以 太 币 ) 。 

* https://www. reddit. com/r/ethereum/comments/3kdnus/question about pr 
ivate chain mining dont upvote/ 

* http://adeduke. com/2015/08/how-to-create-a-private-ethereum-chain/ 




















第 六 章 账户 、 交 易 核 心 概念 及 投注 合约 
6.1 外 有 账户 vs 合约 账户 


以 太 坊 中 有 两 种 类 型 的 账户 

* AES OIM JE" 

。 合约 账户 

它们 的 区 别 在 Serenity 版 本 中 可 能 会 消失 。 


外 有 账户 〈EOA) 

外 有 账户 

。 有 以 太 币 余额， 

。 可 以 发 送 交 易 〈 以 太 币 交易 或 引发 合约 代码 ) ， 
。 由 私 钥 控制 ， 

。 没有 相关 代码 。 











合约 账户 

合约 

。 有 以 太 币 余额 ， 

。 有 相关 代码 ， 

。 代码 执行 由 从 其 他 合约 接收 的 交易 或 信息 〈 调 用 ) 触发 ， 

执行 的 时 候 一 执行 任意 复杂 的 操作 (图 灵 完 备 的 ) 一 操控 它 自己 的 永久 存储 ， 
例如 ， 可 以 有 自己 的 持久 状态 一 可 以 调用 其 他 合约 














24 


ww ai bbt. com [10 UO EO. D 


wangxiaoming.com 


以 太 坊 区 块 链 上 的 所 有 行为 都 由 外 有 账户 引发 的 交易 调动 .每 次 合约 账户 接收 到 
交易 时 ， 它 的 代码 都 按照 输入 参数 的 指示 执行 ， 作 为 交易 的 一 部 分 发 送 。 合 约 代 
码 由 参与 到 网 络 的 每 个 节点 上 的 以 太 坊 虚拟 机 执行 ， 作 为 验证 新 区 块 的 一 部 分 。 



































这 个 执行 需要 是 完全 确定 性 的 , 它 唯 一 的 语 境 是 区 块 链 上 区 块 的 位 置 和 所 有 可 见 
的 数据 。 区 块 链 上 的 区 块 代表 时 间 单 位 ， 区 块 链 本 身 是 时 间 维 度 ， 代表 在 链 上 区 
块 指定 的 离散 的 时 间 点 上 状态 的 整个 历史 。 























所 有 的 以 太 币 余额 和 价值 都 以 wei 为 单位 命名 : 1 个 以 太 币 是 1el8 wei. 








注意 : 以 太 坊 中 的 “合约 ”不 应 该 被 看 做 是 要 “实现 ”或 “遵守 ”的 事物 ， 它 更 
像 是 在 以 太 坊 执行 环境 中 生存 的 “自治 代理 ”， 被 信息 或 交易 “ 惟 到 ”的 时 候 ， 
总 会 执行 特定 的 代码 片段 ， 并 且 对 自己 的 以 太 币 余额 和 钥匙 /价值 商店 有 直接 的 
控制 ， 以 储存 永久 状态 。 





























6.2 什么 是 交易 ? 





“交易 ”这 个 术语 用 在 以 太 坊 中 来 指 代 签 署 的 数据 包 ,， 数据 包 存储 着 要 从 外 有 账 

户 发 送 到 区 块 链 上 另 一 账户 的 信息 。 

交易 包括 : 

。 信息 接 收入， 

。 一 个 签字 ， 用 以 确认 发 送 方 身份 ， 证 明 通 过 区 块 链 向 接收 者 发 送信 息 的 意图 ， 
* VALUE 域 一 从 发 送 方向 接收 方 转移 的 wei 的 数量 ， 
。 可 选 数 据 域 ， 包 括 发 送 到 合约 的 信息 ， 

。 一 个 STARTGAS 值 ， 代 表 交 易 执行 允许 采取 的 运算 步骤 的 最 大 数量 ， 
e 一 个 GASPRICE 值 ， 代 表 发 送 人 愿意 支付 的 gas 费用 。 一 个 gas 单位 对 应 着 一 

个 原子 指令 执行 ， 比 如 运算 步 又。 
























































6.3 什么 是 信息 ? 


合约 能 够 向 其 他 合约 发 送 “ 信 息 ”。 信息 是 虚拟 的 事物 ， 永 远 不 能 序列 化 ， 只 存 
在 于 以 太 坊 执行 环境 中 。 他 们 可 以 被 想象 为 功能 调用 。 
信息 包括 : 

。 信 息 发 送 方 (内 含 的 ) 

。 信 息 接收 方 

* VALUE 域 一 和 发 送 到 合约 地 址 的 信息 一 起 转移 的 wei 数量 ， 
。 可 选 数据 域 ， 即 发 送 到 合约 的 实际 数据 

。 一 个 STARTGAS 值 ， 限 制 了 信息 可 以 触发 的 代码 执行 的 gas 最 大 值 。 
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本 质 上 来 说 ,一 个 信息 就 像 一 个 交易 ， 只 不 过 信息 是 由 合约 而 不 是 由 外 在 因素 创 
造 的 。 当 正在 执行 代码 的 合约 执行 CALL 或 DELEGATECALL 操作 码 时 ， 信 息 就 产 
生 了 。 和 交易 一 样 ， 信 息 可 能 会 导致 接收 方 账 户 运行 代 码 。 因 此 ， 就 像 和 外 在 因 
素 建立 关系 一 样 ， 合约 也 能 以 同样 的 方式 和 其 他 合约 建立 关系 。 






























































6.4 什么 是 gas? 


以 大 坊 虚拟 机 EVM) 是 以 太 坊 区 块 链 上 的 可 执行 环境 。 每 个 参与 到 网 络 的 节点 运 
ÍT EVM, 作为 区 块 验 证 协议 的 一 部 分 。 他 们 检查 列 在 区 块 上 的 、 他 们 验证 的 交易 ， 
运行 EVM 内 部 交易 触发 的 代码 。 每 个 网 络 上 的 完整 节点 进行 同样 的 运算 , 储存 相 
同 的 值 。 很 明显 以 太 坊 并 不 是 关于 运算 效率 的 优化 。 它 类 似 的 进程 是 多 余 的 。 它 
的 目的 是 提供 一 个 有 效 的 方式 , 在 系统 状态 上 不 需要 信任 的 第 三 方 、 准则 或 暴力 
玲 断 就 能 达成 共识 。 但 重要 的 是 他 们 不 是 为 了 优化 运算 而 存在 。 事实 上 , 合约 执 
行 在 季 点 之 间 被 多 余地 重复 , 目 然 使 之 更 昂贵 , 通常 会 鼓励 人 们 如 果 能 在 链 外 操 
作 运 算 ， 就 不 在 区 块 链 里 进行 。 










































































运行 去 中 心 化 应 用 (dapp) 时 , 它 和 区 块 链 互动 来 阅读 和 修正 状态 , 但 是 去 中 心 化 
应 用 会 很 典型 地 只 把 业务 逻辑 和 对 内 5 识 至 关 重 要 的 状态 放 在 区 块 链 上 。 























当 信息 或 交易 触发 结果 执行 时 , 每 个 指令 在 每 个 网 络 节点 被 执行 .这 有 一 个 代价 : 
每 个 执行 的 操作 都 有 特定 的 成 本 ， 以 一 定量 的 gas 单元 表现 。 


























Gas 是 交易 发 送 方 需要 为 每 个 以 太 坊 区 块 链 上 发 生 的 操作 所 支付 的 执行 花费 。 
个 名 字 gas 的 灵感 来 自 这 样 一 个 观点 ,， 这 笔 花 费 就 像 加 密 燃料 ， RP Eie Aj 
^E, Gas 从 执行 代码 的 矿工 处 购买 以 获得 以 太 币 。Gas 和 以 太 币 被 故意 分 开 ， 因 
为 gas 单位 与 具备 自然 成 本 的 运算 单位 一 
量 产生 波动 。 二 者 申 自由 市 场 调和 : gas 价格 实际 上 由 矿工 决定 ， 矿 工 可 以 拒绝 
以 低 于 最 低 限 度 的 gas 价格 进行 交易 。 为 了 获得 gas， 你 只 需要 问 账 户 中 添加 以 
太 币 。 以 太 坊 客户 端 会 自动 为 你 的 以 太 币 购买 gas， 数 量 是 你 指定 的 交易 最 大 文 
出 。 













































































在 合约 或 交易 执行 的 每 个 运算 步 又， 以 太 坊 协议 都 要 收费 ， 以 防止 以 太 坊 网 络 上 
发 生 蓄意 攻击 或 滥用 .每 个 交易 都 必须 包含 一 个 gas 限度 和 每 gas 愿意 支付 的 花 
9t. 矿工 可 以 选择 是 天 将 交易 包括 在 内 和 收集 花费 。 如 果 交 易 产 生 的 、 用 于 运算 
步骤 的 gas 总 量 , 包括 原始 信息 和 可 能 引发 的 子 信 息 ， 少 于 或 等 于 gas 限额 那 
么 交易 就 会 进行 。 如 果 gas 总 量 超过 gas 限额 ,那么 所 有 的 变化 都 复原 ,但 是 交 
易 仍 然 有 效 ， 矿工 仍然 可 以 收集 花费 。 未 用 于 交易 执行 的 、 所 有 多 余 的 gas 都 会 
以 以 太 币 的 形式 偿还 给 发 送 方 。 不 必 担 心 超支 ， 因 为 只 会 对 你 消费 的 gas 收费 。 
这 意味 着 以 高 于 预 估 的 gas 限额 发 送 交 易 也 是 有 效 和 安全 的 。 
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6.5 估算 交易 成 本 





交易 花费 的 以 太 币 总 量 基于 两 个 因素 : 
gasUsed 是 交易 消费 的 gas ME 
gasPrice 交易 中 指定 的 一 个 gas 单元 的 价格 (换算 成 以 太 币 ) 
总 成 本 = gasUsed * gasPrice 











gasUsed 

以 太 坊 虚拟 机 上 的 每 个 操作 都 会 被 指派 消费 的 gas 数量 。gasUsed 是 所 有 执行 的 
操作 所 需 的 gas 总 额 。 有 个 电子 表格 可 以 看 到 背后 的 一 些 统计 。 

对 于 估算 gasUsed， 可 以 用 estimate Gas API 但 是 有 些 警 告 说 明 。 

gasPrice 

用 户 建构 并 签署 交易 ， 每 个 用 户 可 以 说 明 自 己 想 要 的 gasPrice， 可 以 是 零 。 然 
而 Frontier 发 布 的 以 太 坊 客户 端 默认 gasPrice 是 0.05e12 wei。 由 于 矿工 会 使 
收入 最 优化 ， 如 果 大 部 分 交易 都 以 0. 05e12 wei 的 gasPrice 提交 ， 就 很 难说 服 
矿工 接受 价格 更 低 或 为 0 的 交易 。 

示例 交易 成 本 

我 们 来 做 一 个 只 添加 2 个 数字 的 合约 。EVM OPCODE ADD 消费 3 gas. 

大 概 的 成 本 ， 以 默认 gas 价格 计算 (2016 年 1 月 ) 是 : 

3 * 0.05e12 = 1.5ell wei 

1 以 太 币 是 1e18 wei， 总 成 本 就 是 0. 00000015 以 太 币 。 

这 是 个 简化 的 计算 ， 因为 忽略 了 一 些 成 本 ， 比 如 将 2 个 数字 转移 给 合约 的 成 本 ， 
在 他 们 可 以 被 添加 之 前 。 

* question 

* gas 费用 

* gas 成 本 计算 器 

。 以 太 坊 Gas 价格 






























































操作 名 称 gas 成 本 备注 
每 个 执行 循环 的 默认 数 

step 1 B 
stop 0 免费 
suicide 0 免费 
sha3 20 
sload 20 移出 永久 存储 
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sstore 100 放 进 永久 存储 
balance 20 
create 100 合约 创建 
call 20 发 起 一 个 只 读 调 用 
— 扩展 内 存 时 每 个 领 外 的 
词 
一 个 交 个 
txdata 5 数据 字 
transaction 500 基础 费用 交易 
. E homestead 21000 
contract creation 53000 ied TA 


6.6 账户 交互 示例 一 投注 合约 


之 前 提 到 过 ， 有 两 种 类 型 的 账户 : 

， 外 有 账户 〈EOA) : 由 私 钥 控制 的 账户 ， 如 果 你 有 和 外 有 账户 相关 的 私 铀 ， 就 能 
从 账户 发 送 以 太 币 和 信息 。 
。 合约 : 有 自己 代码 的 账户 ， 受 代码 控制 。 
































以 太 坊 默认 的 执行 环境 是 没有 生命 的 , 什么 都 不 会 发 生 , 每 个 账户 的 状态 保持 相 
同 。 但 是 ， 每 个 用 户 都 可 以 通过 从 外 有 账户 发 送 交 易 来 触发 行动 ， 启 动 以 太 坊 。 
如 果 交 易 的 目的 地 是 其 他 外 有 账户 , 交易 可 能 会 转移 一 些 以 太 币 , TTA UA 
会 做 。 但 如 果 目 的 地 是 个 合约 ， 反之 合约 会 激活 ， 自 动 运行 代码 。 

代码 有 能 力 读 / 写 自己 的 内 部 存储 (一 个 将 32 学 节 钥 是 映射 到 32 字 节 价 值 的 数据 
库 ) ， 阅 读 存 储 的 接收 信息 ， 给 其 他 合约 发 送信 息 ， 转 而 触发 执行 。 一 旦 执行 售 
止 ， 合 约 发 送 的 信息 所 触发 的 所 有 的 子 执行 都 会 停止 (这 些 都 以 决定 好 的 同步 的 
顺序 发 生 ， 比 如 ， 子 调用 在 父 调 用 进一步 之 前 完全 完成 )， 执 行 环境 立即 再 次 停 
止 ， 直 到 被 下 一 个 交易 唤醒 。 


















































合约 通常 服务 于 四 个 目的 : 
”保持 数据 库 代 表 着 对 其 他 合约 或 外 部 世界 有 用 的 东西 ;一 个 例子 是 合约 激励 货 
币 ， 男 一 个 例子 是 合约 在 特定 的 组 织 里 记录 会 员 。 
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。 作 为 某 种 具有 更 复杂 访问 政策 的 外 有 账户 ， 被 称 为 “前 向 合约 ”， 典 型 地 只 在 
特定 条 件 下 ， 把 进来 的 信息 转发 给 到 指定 目的 地 ; 例如 ， 前 向 合约 可 能 会 等 到 指 
XE 3 个 私 钥 中 的 2 个 都 确认 了 特定 的 信息 之 后 才 会 进行 转发 (例如 ， 多 重 签名 ) 。 
更 复杂 的 前 向 合约 基于 要 发 送 的 信息 会 有 不 同 的 条 件 。 最 简单 的 一 个 功能 使 用 案 
例 就 是 撤回 限制 , 在 一 些 更 复杂 的 访问 政策 中 难以 轨 驭 。 钱 包 合约 就 是 个 很 好 的 
例子 。 
"在 多 个 用 户 之 间 管 理 一 个 正在 进行 的 合约 或 关系 。 例 子 包 括 金 融合 约 ， 有 特定 
中 介 的 第 三 方 保管 合约 , 或 一 些 保险 。 也 可 以 是 开放 合约 , 一 方 对 其 他 方 的 随时 
参与 保持 开放 ; 一 个 例子 是 目 动 给 提交 数学 问题 有 效 解决 方案 或 是 证 明 提供 了 一 
些 运算 资源 的 人 发 奖金 的 合约 。 

给 其 他 合约 提供 功能 ， 本 质 上 作为 软件 库 。 
合约 通过 被 交替 叫做 “调用 ”或 “发 送信 息 ”的 活动 进行 互动 。“ 信 息 ” 是 包含 
一 定量 以 太 币 ， 任 何 大 小 的 数据 字 节 串 ， 发 送 方 和 接收 方 地 址 的 事物 。 合 约 接收 
信息 时 ， 可 以 选择 返还 一 些 数据 ， 信 息 本 来 的 发 送 方 可 以 立即 使 用 。 这 样 发 送 
信息 就 和 调用 一 个 功能 一 样 。 




























































































































































































因为 合约 有 这 样 的 作用 , 我 们 期 望 合 约 可 以 彼此 互动 。 举 个 例子 , 设想 一 个 情景 ， 
Alice 和 Bob 赌 100 Gav 币 ， 明 年 旧金山 的 温度 不 会 超过 35"C。 但 是 Alice 非常 
有 安全 意识 , 她 的 第 一 个 账户 使 用 的 前 向 合约 , 只 有 在 3 个 私 钥 中 的 2 个 都 批准 
的 情况 下 才 可 以 发 送信 息 。Bob 偏执 于 量子 加 密 图 形 ， 他 使 用 的 前 向 合约 ， 只 传 
3E Lamport 签名 和 传统 ECDSA 的 信息 (但 是 因为 他 很 老 派 ， 所 以 更 偏向 于 用 基 
于 SHA256 的 Lamport 签名 版 本 ， 以 太 坊 不 直接 支持 ) 。 













































































投注 合约 本 身 需 要 从 一 些 合约 中 取得 旧金山 天 气 的 数据 ， 当 它 想 要 实际 发 送 Gav 
币 给 Alice 或 Bob 时， 也 需要 和 Gav 币 合 约 交谈 (或 者 ， 更 准确 地 说 ，Alice EX 
Bob 的 前 向 合约 ) 。 因 次 我 们 可 以 这 样 表示 账户 之 间 的 关系 : 
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Bob 想 最 终 决定 赌注 的 时 候 ， 就 会 发 生 以 下 的 步 又 : 

1，、 交 易 被 发 出 ， 触 发 信息 从 Bob 的 外 有 账户 发 送 到 他 的 前 向 合约 。 

2. Bob 的 前 向 合约 给 合约 发 送信 息 散 表 和 Lamport 签名 ， 发 挥 Lamport 签名 确 
认 库 的 作用 。 

3. Lamport 签名 确认 库 看 到 Bob 想 要 基于 SHA256 的 Lamport 签名 ,于 是 给 SHA256 
库 多 次 发 调用 来 确认 签名 。 

4. Lamport 签名 确认 库 一 旦 回 到 1， 表明 签名 已 确认 ， 他 就 会 给 代表 赌注 的 合约 
发 送信 息 。 

5， 赌 注 合 约 检查 提供 旧金山 天 气 的 合约 ， 查 看 天 气 如何 。 

6. 赌注 合约 看 到 对 信息 的 回应 显示 天 气 高 于 35°C, 就 会 给 Gav 币 合 约 发 送信 息 ， 
将 Gav 币 从 它 的 账户 转移 到 Bob 的 前 向 合约 。 











注意 Gav 币 在 Gav 币 合约 的 数据 库 中 作为 一 个 整体 “储存 ”; 第 6 步 语 境 中 “上 账 
户 ” 的 意思 只 是 说 在 Gav 币 合 约 储存 中 有 数据 入 口 ， 有 钥匙 可 以 进入 赌注 合约 的 
地 址 和 余额 值 。 接 收 到 信息 后 ，Gav 币 合 约 值 上 减少 ， 与 Bob 前 向 账户 对 应 的 入 
口 值 增加 。 

我 们 可 以 在 下 表 看 到 这 些 步 又 : 
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合约 是 代码 〈 它 的 功能 ) 和 数据 〈 它 的 状态 ) 的 集合 ， 存 在 于 以 太 坊 区 块 链 的 特 
定 地 址 。 合约 账户 能 够 在 彼此 之 间 传 递 信息 ， 进 行 图 灵 完 备 的 运算 。 合 约 依靠 
被 称 作 以 太 坊 虚 拟 机 (EVM) 字 节 代码 (以太 坊 特 有 的 二 进 制 格式 ) 上 的 区 块 链 运 
fi. 

合约 很 典型 地 用 诸如 Solidity 等 高 级 语言 写成 ， 然 后 编译 成 字 节 代码 上 传 到 区 
块 链 上 。 














也 存在 其 他 语言 ， 尤其 是 Serpent 和 LLL， 在 此 文本 的 以 太 坊 高 级 语言 章节 会 
进一步 前 述 。 去 中 心 化 应 用 开发 资源 列 出 了 综合 的 开发 环境 ， 帮 助 你 用 这 些 语言 
开发 的 开发 者 工具 ， 提 供 测 试 ， 和 部 署 支持 等 功能 。 
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7.2 以 太 坊 高 级 语言 


合约 依靠 被 称 作 以 太 坊 虚拟 机 (EVMW 字 节 代码 (以 太 坊 特有 的 二 进 制 格式 ) 上 的 
区 块 链 运行 。 然 而 ， 合 约 很 典型 地 用 诸如 Solidity 等 高 级 语言 写成 ， 然 后 用 以 
太 坊 虚拟 机 编译 器 编译 成 字 节 代码 上 传 到 区 块 链 。 

下 面 是 开发 者 可 以 用 来 为 以 太 坊 写 智能 合约 的 高 级 语言 。 

Solidity 

Solidity 是 和 JavaScript 相似 的 语言 ， 你 可 以 用 它 来 开发 合约 并 编译 成 以 太 坊 
虚拟 机 字 节 代码 。 

它 目前 是 以 太 坊 最 受 欢迎 的 语言。 | 

e Solidity XÆ - Solidity 是 以 太 坊 的 旗舰 高 级 语言 ， 用 于 写 合约 。 

e Solidity 在 线 实时 编译 器 

。 标 准 合约 API 

。 有 用 的 去 中 心 化 模式 - 用 于 去 中 心 化 应 用 开发 的 代码 片段 。 

Serpent 

Serpent 是 和 Python 类 似 的 语言 ， 可 以 用 于 开发 合约 编译 成 以 太 坊 虚拟 机 字 节 
代码 。 它 力求 简洁 ， 将 低级 语言 在 效率 方面 的 优点 和 编程 风格 的 操作 简易 相 结 
合 ， 同 时 合约 编程 增加 了 独特 的 领域 特定 功能 。Serpent 用 LLL 编译 。 

。 以 太 坊 维基 百科 上 的 Serpent 

* Serpent 以 太 坊 虚拟 机 编译 器 

LLE 

Lisp Like Language (LLL) ZÉ4H Assembly 类 似 的 低级 语言 。 它 追求 极 简 ， 本质 
上 只 是 直接 对 以 太 坊 虚拟 机 的 一 点 包装 。 
e GitHub 上 的 LIBLLL 

* LLL 实例 

Mutan (GERD 

Mutan 是 个 静态 类 型 ， 由 Jeffrey Wilcke 开发 设计 的 C 类 语言 。 它 已 经 不 再 受 
到 维护 。 

























































































7.3 写 合约 














HA Hello World 程序 ， 语 言 就 不 完整 。Solidity 在 以 太 坊 环境 内 操作 ， 没 有 
明显 的 “输出 ” 字符 串 的 方式 。 我 们 能 做 的 最 接近 的 事 就 是 用 日 志 记 录 事 件 来 把 
字符 串 放 进 区 块 链 : 














contract HelloWorld { 

event Print(string out); 

function) { Print("Hello, World!^); } 
} 
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每 次 执行 时 ， 这 个 合约 都 会 在 区 块 链 创 建 一 个 日 志 入 口 ， 印 着 “Hello, World!" 
参数 。 

另 请 参阅 : 

Solidity docs 里 有 更 多 写 Solidity 代码 的 示例 和 指导 。 








7.4 编译 合约 





solidity 合约 的 编译 可 以 通过 很 多 机 人 制 完成 。 
。 通过 命令 行使 用 solc 编译 器 。 
* 在 geth 或 eth 提供 的 javascript 控制 台 使 用 web3. eth. compile. solidity 
(这 仍然 需要 安装 solc 编译 器 ) 。 
* 在线 Solidity 实时 编译 器 。 
。 建立 solidity 合约 的 Meteor dapp Cosmo. 
e Mix IDE. 
。 以 太 坊 钱包 。 









































注意 : 关于 sole 和 编译 Solidity 合约 代码 的 更 多 信息 可 在 此 查看 。 





在 geth 设置 solidity 编译 器 
如 果 你 启动 了 geth 节点 ， 就 可 以 查看 哪个 编译 器 可 用 。 


> web3. eth. getCompilers(); 
[^111^, "solidity^, "^serpent"] 


这 一 指令 会 返回 到 显示 当前 哪个 编译 器 可 用 的 字符 串 。 

















注意 : sole 编译 器 和 cpp- ethereum 一 起 安装 。 或 者 ， 你 可 以 自己 创建 。 





如 果 你 的 sole 可 执行 文件 不 在 标准 位 置 ， 可 以 用 一 solc 标志 为 sole 可 执行 文 
件 指定 一 个 定制 路 线 。 


$ geth —solc /usr/local/bin/solc 
或 者 你 可 以 通过 控制 台 在 执行 期 间 设 置 这 个 选项 ; 


> admin. setSolc ("/usr/local/bin/solc^) 

solc, the solidity compiler commandline interface 
Version: 0.2. 2-02bb315d/. -Darwin/appleclang/JIT linked to 
libethereum-l. 2. 0-8007cef0/. -Darwin/appleclang/JIT 

path: /usr/local/bin/solc 
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编译 一 个 简单 合约 

让 我 们 编译 一 个 简单 的 合约 源 : 
> source = "contract test { function multiply(uint a) 
returns (uint d) { return a * 7; ) ] 


这 个 合约 提供 了 一 个 单一 方法 multiply， 它 和 一 个 正 整 数 a 调用 并 返回 到 ax7。 
你 准备 在 geth JS 控制 台 用 eth. compile. solidity() 编 译 solidity 代码 : 


^ 




















> contract = eth. compile. solidity (source). test 

{ 

code: 

” 605280600c6000396000f3006000357c010000000000000000000000000000000000 
000000000000000000000090048063c6888fa114602e57005b60376004356041565b8 
060005260206000f35b6000600782029050604d565b91905056”， 
info: { 

language: 'Solidity', 

languageVersion: '0', 

compilerVersion: '0.9.13', 

abiDefinition: [{ 

constant: false, 

inputs: [{ 

name: 'a', 

type: 'uint256' 

} J 

name: 'multiply', 

outputs: [1 

name: 'd', 

type: 'uint256' 

t. 

type: 'function' 

} ]， 

userDoc: { 

methods: { 

j 

P 

developerDoc: { 

methods: { 

j 

h 

source: 'contract test ( function multiply(uint a) returns(uint d) 
[ return a 

* 


(Xa 
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注意 : 编译 器 通过 RPC 因此 也 能 通过 web3. js， 对 浏览 器 内 任何 通过 RPC/ IPC XE 
接 到 geth 的 Bapp 可 用 。 





下 面 的 例子 会 加 你 展示 如 何 通过 JSON-RPC 接合 geth 来 使 用 编译 器 。 


$ geth —datadir /eth/ —loglevel 6 —logtostderr-true --Tpc ——rpcport 
8100 ——rpccorsdomain ' * ' --mine console 2>> "/eth/eth. log 

$ curl -X POST --data 

' ( jsonrpc^ : ^2. 0", "method" :^eth compileSolidity”,” params” :[”contract 
test | 


单 源 编 译 器 输出 会 给 出 你 合约 对 象 ， 每 个 都 代表 一 个 单独 的 合约 。 
eth. compile. solidity 的 实际 返还 值 是 合约 名 字 到 合约 对 象 的 映射 。 由 于 合约 
名 字 是 test, eth. compile. solidity (source). test 会 给 出 包含 下 列 领 域 的 测试 
合约 对 : 

Code 编译 的 以 太 坊 虚拟 机 字 节 代码 

Info 从 编译 器 输出 的 额外 元 数据 

Source 源 代码 

Language 合约 语言 (Solidity, Serpent, LLL) 

LanguageVersion 合约 语言 版 本 

compilerVersion 用 于 编译 这 个 合约 的 solidity 编译 器 版 本 。 

abiDefinition 应 用 的 二 进 制 界面 定义 

userDoc 用 户 的 NatSpec Doc. 

developerDoc 开发 者 的 NatSpec Doc。 

编译 器 输出 的 直接 结构 化 (到 code 和 info) 反映 了 两 种 非常 不 同 的 部 署 路 径 。 编 
译 的 以 太 坊 虚拟 机 代码 和 一 个 合约 创建 安 易 被 发 送 到 区 块 , 剩 下 的 (info) 在 理想 
状态 下 会 存活 在 去 中 心 化 云 上 ， 公 开 验 证 的 元 数据 则 执行 区 块 链 上 的 代码 。 

如 果 你 的 源 包含 多 个 合约 , 输出 会 包括 每 个 合约 一 个 入 口 ， 对 应 的 合约 信息 对 象 
可 以 用 作为 属性 名 称 的 合约 名 字 检 索 到 。 你 可 以 通过 检测 当前 的 
GlobalRegistrar RERA — F: 









































注 














contracts = eth. compile. solidity (globalRegistrarSrc) 
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7.5 创建 和 部 署 合约 











开始 这 一 章节 之 前 ， 确 保 你 有 解锁 的 账户 和 一 些 资金 。 
你 现在 会 在 区 块 链 上 创建 一 个 合约 , 方法 是 用 上 一 章节 的 以 太 坊 虚拟 机 代码 作为 
数据 给 空地 址 发 送 交 易 。 
































注意 : 用 在 线 Solidity 实时 编译 器 或 Mix IDE 程序 会 更 容易 完成 。 


var primaryAddress = eth. accounts[0] 

var abi = [{ constant: false, inputs: [{ name: 'a', type: 
'uint256. ) | 

var MyContract = eth. contract (abi) 

var contract = MyContract.new(argl, arg2, ..., {from: 
primaryAddress, data: evmByteCodeFromPrevio 








所 有 的 二 进 制 数据 都 以 十 六 进 制 的 格式 序列 化 。 十 六 进 制 字符 串 总 会 有 一 个 十 六 
XE Bid Ox. 











注意 : 注意 argl，arg2，... ERAEN, Ua ERREA WA 
约 不 需要 构造 函数 参数 ， 就 可 以 忽略 这 些 参数 。 














值得 指出 的 是 ， 这 一 步骤 需要 你 文 付 执行 。 一 旦 交易 成 功 进入 到 区 块 ， 你 的 账户 
余额 (你 作为 发 送 方 放 在 from 领域 ) 会 根据 以 太 坊 虚拟 机 的 gas 规则 被 扣 减 。 一 
段 时 间 以 后 ， 你 的 交易 会 在 一 个 区 块 中 出 现 ， 确 认 它 带 来 的 状态 是 共识 。 你 的 合 
约 现在 存在 于 区 块 链 上 。 

以 不 同步 的 方式 做 同样 的 事 看 起 来 是 这 样 : 


MyContract.new([argl, arg2, ..., | {from: primaryAccount, data: 
evmCode], function(err, contract) { 

if (lerr && contract. address) 

console. log (contract. address) ; 


I 


























7.6 与 合约 互动 





与 合约 互动 典型 的 做 法 是 用 诸如 eth. contract 0 功能 的 抽象 层 ， 它 会 返回 到 
javascript 对 象 , 和 所 有 可 用 的 合约 功能 一 起 , 作为 可 调用 的 javascript 功能 。 
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述 合约 可 用 功能 的 标准 方式 是 ABI 定义 。 这 个 对 象 是 一 个 字符 串 , 它 描述 了 调 
签名 和 每 个 可 用 合约 功能 的 返回 值 。 


























dH gi 





var Multiply? = eth. contract (contract. info. abiDefinition); 
var myMultiply7 = Multiply7. at (address) ; 


现在 ABI 中 有 具体 说 明 的 所 有 功能 调用 都 在 合约 实例 中 可 用 。 你 可 以 用 两 种 方法 中 
的 一 种 来 调用 这 些 合约 实例 上 的 方法 。 


> myMultiply7. multiply. sendTransaction(3, {from: addressj) 
^0x12345^ 

> myMultiplyT. multiply. call (3) 

21 

















当 用 sendTransaction 被 调用 的 时 候 ， 功 能 调用 通过 发 送 交 易 来 执行 。 需 要 花费 
以 太 币 来 发 送 , 调用 会 永久 记录 在 区 块 链 上 。 用 这 种 方式 进行 的 调用 返回 值 是 交 
DAK o 

当 用 call 被 调用 的 时 候 ， 功 能 在 以 太 坊 虚拟 机 被 本 地 执行 ， 功 能 返回 值 和 功能 
一 起 返回 。 用 这 种 方式 进行 的 调用 不 会 记录 在 区 块 链 上 ， 因 此 也 不 会 改变 合约 内 
部 状态 。 这 种 调用 方式 被 称 为 恒定 功能 调用 。 以 这 种 方式 进行 的 调用 不 花费 以 大 
币 。 

如 果 你 只 对 返回 值 感 兴趣 ， 那 么 你 应 该 用 call 。 如 果 你 只 关心 合约 状态 的 副 作 
用 ， 就 应 该 用 sendTransaction。 

在 上 面 的 例子 中 ， 不 会 产生 副作用 ， 因 此 sendTransaction 只 会 烧 gas， 增 加 宇 
Bi ITA o 

















7.7 合约 元 数据 


在 之 前 的 章节 , 我 们 揭示 了 怎样 在 区 块 链 上 创建 合约 。 现 在 我 们 来 处 理 剩 下 的 编 
译 咒 输出， 合约 元 数据 或 者 说 合约 信息 。 

当 与 不 是 你 创建 的 合约 互动 时 , 你 可 能 会 想 要 文档 或 者 查看 源 代码 。 合约 作者 被 
鼓励 提供 这 样 的 可 见 信息 , 他们 可 以 在 区 块 链 上 登记 或 者 借助 第 三 方 服务 ， 比 如 
说 EtherChain。 管 理 员 API 为 所 有 选择 登记 的 合约 提供 便利 的 方法 来 获取 这 个 
捆绑 。 













































































// get the contract info for contract address to do manual verification 
var info = admin. getContractInfo(address) // lookup, fetch, decode 
var source - info. source; 

var abiDef - info.abiDefinition 


这 项 工作 的 潜在 机 制 是 : 
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。 合约 信息 被 可 以 公开 访问 的 URI 上 传 到 可 辨认 的 地 方 

。 任何 人 都 可 以 只 知道 合约 地 址 就 找到 是 什么 URI 

仅 通 过 2 个 步骤 的 区 块 链 注册 就 可 以 实现 这 些 要 求 。 第 一 步 是 在 被 称 作 HashReg 
的 合约 中 用 内 容 散 表 注 册 合 约 代 码 AR) 。 第 二 步 是 在 UrlHint 合约 用 内 容 散 
表 注 册 一 个 url。 这 些 注册 合约 是 Frontier 版 本 的 一 部 分 , 已 经 参与 到 Homestead 
中 。 
要 知道 合约 地 址 来 查询 ur1， 获 取 实 际 合约 元 数据 信息 包 ， 使 用 这 一 机 制 就 足够 
Ts 

如 果 你 是 个 尽职 的 合约 创建 者 ， 请 遵循 以 下 步骤 ; 

1， 将 合约 本 身 部 署 到 区 块 链 

2， 获 取 合 约 信息 json 文件 

3， 将 合约 信息 json 文件 部 署 到 你 选择 的 任意 url 

4. 注册 代码 散 表 -> 内 容 散 表 -> url 

JS API 通过 提供 助手 把 这 个 过 程 变 得 非常 容易 。 调用 admin. register 从 合约 
中 提取 信息 ， 在 指定 文件 中 写 出 json 序列 ， 运 算 文 件 的 内 容 散 表 ， 最 终 将 这 个 
内 容 散 表 注 册 到 合约 代码 散 表 。 一 旦 将 那个 文件 部 署 到 任意 url1， 你 就 能 用 
admin. registerUrl 来 注册 url 和 你 区 块 链 上 的 内 容 散 表 (注意 一 旦 固定 的 内 容 
选 址 模式 被 用 作文 件 商 店 ，url-hint 不 再 必要 了 。) 


source - "contract test { function multiply(uint a) returns(uint d) 
{ return a 

* 

de cp qm 


// compile with solc 



















































































contract = eth. compile. solidity (source). test 

// create contract object 

var MyContract = eth. contract (contract. info. abiDefinition) 

// extracts info from contract, save the json serialisation in the given 
file, 

contenthash = admin. saveInfo (contract. info, 

"^ /dapps/shared/contracts/test/info. json ) // send off the contract to 
the blockchain 

MyContract. new( {from: primaryAccount, data: contract. code], 
function(error, contract) { 

if(lerror && contract. address) { 

// calculates the content hash and registers it with the code hash in 
"HashReg 

// it uses address to send the transaction. 

// returns the content hash that we use to register a url 
admin.register(primaryAccount, contract.address, contenthash) 

// here you deploy "/dapps/shared/contracts/test/info. json to a url 
admin.registerUrl(primaryAccount, hash, url) 


) 
); 
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7.8 测试 合约 和 交易 





你 通常 需要 低级 的 测试 策略 , 为 交易 和 合约 排除 夏 障 。 这 一 章节 介绍 了 一 些 你 可 
以 用 到 的 排 错 工 作 和 做 法 。 为 了 测试 合约 和 交易 而 不 产生 实际 的 后 果 , 你 最 好 在 
私有 区 块 链 上 测试 。 这 可 以 通过 配置 一 个 替代 网 络 ID (选择 一 个 特别 的 数字 ) 和 
/或 不 能 用 的 端点 来 实现 。 推 荐 做 法 是 ,为 了 测试 你 用 一 个 奉 代 数据 目录 和 端口 ， 
这 样 就 不 会 意外 地 和 实时 运行 的 节点 神 突 (假定 用 默认 运行 。 在 虚拟 机 排 错 模式 
开启 geth， 推 荐 性 能 分 析 和 最 高 的 日 志 克 余 级 别 : 












































geth --datadir "/dapps/testing/00/ --port 30310 —-rpcport 8110 
—-networkid 4567890 --nodiscover 一 


ELD LA, fru EGENT MAE. NMWA. 


























// create account. will prompt for password 

personal. newAccount () ; 

// name your primary account, will often use it 

primary = eth. accounts [0] ; 

// check your balance (denominated in ether) 

balance = web3. fromWei (eth. getBalance(primary), “ether”); 


// assume an existing unlocked primary account 

primary = eth. accounts [0] ; 

// mine 10 blocks to generate ether 

// starting miner 

miner. start (4) ; 

// sleep for 10 blocks (this can take quite some time). 
admin. sleepBlocks (10) ; 

// then stop mining (just not to burn heat in vain) 
miner. stop ; 

balance = web3. fromWei (eth. getBalance (primary), "ether^); 


创建 交易 之 后 ， 你 可 以 用 下 面 的 命令 来 强制 运行 : 


miner. start (1) ; 




















admin. sleepBlocks (1); 
miner. stop() ; 


你 可 以 用 以 下 命令 查看 即将 发 生 的 交易 : 
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// shows transaction pool 

txpool. status 

// number of pending txs 

eth. getBlockTransactionCount ("pending") ; 
// print all pending txs 

eth. getBlock(/pending/, true). transactions 


A AE TAJBHEASE nup VS AA RA d E Sas E CA 8 7 Bu HEC 
链 : 








txhash = eth. sendTansaction({from:primary, data: code}) 
//... mining 

contractaddress = eth. getTransactionReceipt (txhash) ; 
eth. getCode (contractaddress) 


第 八 章 如 何 部 署 、 调 用 智能 合约 


8.1 RPC 


之 前 的 章节 中 我 们 看 到 了 怎么 写 、 部 署 合 约 以 及 与 合约 互动 。 现 在 该 讲 讲 与 以 大 
坊 网 络 和 智能 合约 沟通 的 细节 了 。 





一 个 以 太 坊 节点 提供 一 个 RPC 界面 。 这 个 界面 给 Dapp 访问 以 太 坊 区 块 链 的 权限 
和 节点 提供 的 功能 ， 比 如 编译 智能 合约 代码 ， 它 用 JSON-RPC 2. 0 规范 (不 支持 提 
醒 和 命名 的 参数 ) 的 子 集 作为 序列 化 协议 , 在 HTTP £I IPC (linux/0SX 上 的 unix 
域 接 口 ， 在 Windows EY pipe’? 9 上 可 用 。 











如 果 你 对 细节 不 感 兴趣 ， 正 在 寻找 使 用 javascript 库 的 简便 方法 ， 你 可 以 略 过 
下 面 的 章节， 从 Using Webs 继续 。 


8.2 惯例 





RPC 界面 使 用 一 些 惯例 ， 它 们 不 是 JSON-RPC 2. 0 规范 的 一 部 分 : 

”数字 是 十 六 进 制 编码 ,做 这 个 决定 是 因为 有 些 语言 对 运行 极 大 的 数字 没有 或 有 
很 少 的 限制 。 为 了 防止 这 些 错误 数字 类 型 是 十 六 进 制 编码 ,由 开发 者 来 分 析 这 些 
数字 并 正确 处 理 它们 。 在 维基 页 百科 查看 士 六 进 制 编码 音节 查看 案例 。 
”默认 区 块 数字 ， 几 个 RPC 方法 接受 区 块 数字 。 在 一 些 情况 下 ， 给 出 区 块 数字 
是 不 可 能 的 或 者 不 太 方便 。 在 那样 的 情况 下 ， 默 认 区 块 数字 可 以 是 以 下 学 符 串 
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中 的 一 个 [”earliest”，“1latest”，“pbending”]|。 在 维基 页 面 查看 使 用 默 
认 区 块 参数 的 RPC 方法 列表 。 


8.3 部 署 合 约 


我 们 会 通过 不 同 的 步骤 来 部 署 下 面 的 合约 ， 只 用 到 RPC 界面 。 


contract Multiply? { 

event Print (uint) ; 

function multiply(uint input) returns (uint) { 
Print (input 

* 

7) ; 

return input 

* 


T; 
] 
} 


— e j 标记 ,在 这 个 例子 中 我 们 用 私有 开发 链 上 的 geth 节点 。 
过 这 各 方法 我 们 就 不 需要 真实 网 络 上 的 以 太 币 了 。 


> geth —rpc --dev --mine --minerthreads 1 --unlock 0 console 2>>geth. log 




















pg — 
况 符 换 需要 的 参数 。 


> curl --data“”{jsonrpc :^2. 0^, "method" :"eth coinbase^, “id”:1}’ 
localhost:8545 

lid" :1, " jsonrpc^ : "2. 0", "result" : [O0xeb85a5557e5bdc18ee1934a89d8bb402 
398ee26a" ]] 

> curl —-data ' (^ jsonrpc" : ^2. 0", "method" :"eth getBalance^, “params”: 
['0xeb85a5557ebbdc18ee1934a89d8bb402398ee26a^], "id":2]' 
localhost:8545 

(^id":2, " jsonrpc^ : "2. 0", "result" :^0x1639e49bba16280000^; 
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记 不 记得 我 们 说 过 数字 是 十 六 进 制 编码 ? 在 这 个 情况 下 , 余额 作为 十 六 进 制 字符 
串 以 Wei 的 形式 返还 。 如 果 我 们 希望 余额 作为 数字 以 太 币 为 单位 , 我 们 可 以 从 探 
制 台 用 web3。 


> web3. fromWei ("0x1639e49bbal16280000^, "ether^) 
"410^ 





现在 我 们 在 私有 开发 链 上 有 一 些 以 太 币 ,我们 就 可 以 部 署 合约 了 。 第 一 步 是 验证 
solidity 编译 器 可 用 。 我 们 可 以 用 eth getCompilers RPC method 方法 来 检索 
可 用 的 编译 器 。 

> curl --data ' (" jsonrpc^ :^2. 07, "method": "eth getCompilers^, "id": 3Y 


localhost:8545 
("id':3, " jsonrpc" :"2. 0^, "result" : [^Solidity"]) 





我 们 可 以 看 到 solidity 编译 器 可 用 。 如 果 不 可 用 ， 按 照 这 些 说 明 操 作 。 
下 一 步 是 把 Multiply7 合约 编译 到 可 以 发 送 给 以 太 坊 虚拟 机 的 字 节 代码 。 


> curl —data ' (^ jsonrpc^:^2. 0", "method": "eth compileSolidity^, 
“params”: [/contract Multiply? { event Print (uint); function 
multiply(uint input) returns (uint) { Print (input 

{"id”:4,” jsonrpc :2.0 "result": ('MultiplyV'": ("code :”0x606060405260 
5f8060106000396000f360606040 














现在 我 们 有 了 编译 代码 ， 需 要 决定 花 多 少 gas 去 部 署 它 。RPC 界面 有 
eth estimateGas 方法 ， 会 给 我 们 一 个 预 估 数量 。 











> curl —data ' (^ jsonrpc^ :^2. 0^, "method": "eth estimateGas^, “params”: 
[(^from": "Oxeb85a5557e5bdc18ee1934a289d8bb402398ee26a^, "data": 
^0x6060604052605f8060106000396000f3606060405260e060020a26000350463c688 
8fa18114601a575b005b60586004356007810260609081526000907 f24abdb5865df5 
079dcc5bac5b90ff6f01d5cl6edbcbfab4el95d9febd1114503da90602090a150600702 
90565b5060206060f3^)], "id": 5]' localhost:8545 

(^id":5, " jsonrpc^ :^2. 0^, "result" :"0xb8a9^] 


最 后 部 署 合约 。 

> curl —-data ' (^ jsonrpc^:^2. 0", "method": ”eth sendTransaction”, 
^params": [("from": "0Oxeb85a5557e5bdc18ee1934a89d8bb402398ee206a^, 
"gas": "Oxb8a9^, "data": 
^0x6060604052605f8060106000396000f3606060405260e06002026000350463c688 
8fa18114601a575b005b60586004356007810260609081526000907f24abdb5865df5 
079dccbacb90ff6f0ld5bcl6edbcbfab4el95d9febd1114503da90602090a150600702 
90565b5060206060f3^)], "id^: 6} localhost:8545 
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l^id^:6, " jsonrpc" :^2. 0^, "result" :"0x3a90b5face52c4c5f30d507ccf51b0209 
ca628c68244d0532bcd6283df 7c08 





St EV BOSE AAE R SA 






~” 4 


method": "eth getTransactionReceipt^, 


> curl —data ' (^ jsonrpc^ :^2. 0^, 
“params : 
[“0x3a90b5face52c4c5f30d507ccf51b0209ca628c6824d0532bcd6283df7c08a7c” 
], “id”: 7 localhost:8545 

l^id':7, " jsonrpc" :^2. 0^, "result": (/transactionHash":"0x3a90b5face52c4 
c5f30d507ccf51b0209ca628c682 


我 们 可 以 看 到 合约 在 Ox6ff93b4b46b41c0c3c9baee01c255d3b4675963d 上 被 创 
建 。 如 果 你 得 到 了 零 而 不 是 接收 ,说 明 还 没有 被 纳入 区 块 。 等 一 下 ,检查 看 看 你 
的 矿工 是 否 在 运行 ， 重 新 试 一 遍 。 








8.4 和 智能 合约 互动 





DERE TET 的 档案 ， 可 以 发 现 我 们 需要 提供 几 个 参数 。 


Xr, m ROSSI from, to 和 data 参数 。Fronm 是 我 们 账户 的 公 
共 地 址 ，to 是 合约 地 址 。Data 参数 有 一 点 困难 。 它 包括 了 规定 调用 哪个 方法 和 

哪个 参数 的 负载 量 。3 这 就 需要 ABI 发 挥 作用 了 。ABI 规定 了 如 何 为 以 太 坊 虚拟 机 

规定 和 编码 数据 。 你 可 以 在 这 儿 阅 读 ABI 的 所 有 具体 信息 。 

选择 符 ， 规 定 了 调用 哪个 方法 。 它 取 Keccak BRIK 4 个 

字 节 ， 涵 盖 功 能 名 称 参 数 类 型 ， 并 进行 十 六 进 制 编码 。multiply 功能 接受 一 个 

这 元 ， 也 就 是 ， 的 别名 。 这 就 让 我 们 进行 : 


> web3. sha3 (“multiply (uint256)^). substring(0, 8) 
“c6888fal” 





在 此 页 查看 细节 。 
下 一 步 是 编码 参数 。 我 们 只 有 一 个 unit256， 让 我 们 假定 提供 了 值 6。ABI 有 一 
个 章节 规定 了 怎么 编码 uint Y m. 
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int: enc(X) is the big-endian two! s complement encoding of X, padded 
on the higher-oder (left) side with Oxff for negative X and with zero 4 
4s for positive X such that the length is a multiple of 32 bytes. 
它 编码 到 
0000000000000000000000000000000000000000000000000000000000000006. 

将 功能 选择 符 和 编码 参数 结合 起 来 ， 数 据 就 会 变 成 
0xc6888fal00000000000000000000000000000000000000000000000000000000000 
00006. 

我 们 来 试 一 下 : 

> curl —data ' (^ jsonrpc^ :^2. 0", "method": "eth sendTransaction”, 
^params": [{’ from": "0Oxeb85a5557e5bdc18ee1934a89d8bb402398ee26a^", 
^to": "Ox6ff93b4b46b41c0c3c9baee01c255d3b4675963d^, "data": 
"0xc6888fa210000000000000000000000000000000000000000000000000000000000 
000006")], "id": 8} localhost:8545 

(^id":8, " jsonrpc :^2. 0^, "result" :"0x759cf065cbc22e9d779748dc53763854e 
53776eea07409e590c990eafc0869 




















由 于 我 们 发 送 了 交易 ， 于 是 有 交易 散 表 返 回 。 如 果 我 们 检索 接收 ， 可 以 看 到 一些 
浙 内 容 : 





blockHash: 
“0xbf0a347307b8c63dd8c1ld3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55”,， 
blockNumber: 268, 

contractAddress: null, 

cumulativeGasUsed: 22631, 

gasUsed: 22631, 

logs: [{ 

address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d^, 

blockHash: 
"0xbf0a347307b8c63dd8c1d3d'7cbdc0b463e6e7c9bf0a35be40393588242f01d55^, 
blockNumber: 268, 

data: 
^0x0000000000000000000000000000000000000000000000000000000000000022a^ , 
logIndex: 0, 

topics: 

[^0x24abdb5865df5079dcc5bac590f f6f01d5cl6edbcb5fab4el95d9febdl114503da^ 
li 

transactionHash: 

"0x 159cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74^, 
transactionIndex: 0 

Pls 


transactionHash: 
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"0x 159cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74^, 
transactionIndex: 0 


} 








接收 包含 一 个 日 志 。 日 志 由 以 太 坊 虚拟 机 在 交易 执行 时 生成 ， 包 含 接收 。 如 果 我 
们 看 Multiply 功能 ， 可 以 看 到 打印 事件 和 输入 次 数 7 一 起 被 提出 。 由 于 打印 事 
件 的 参数 是 uint256， 我 们 可 以 根据 ABI 规则 对 它 进行 编码 ， 这 样 我 们 就 会 得 到 
预期 的 十 进 制 42. 。 除 数据 外 ， 主 题 用 于 决定 什么 事件 来 创建 日 志 ， 是 毫 无 意义 
it: 


> web3. sha3 (Print (uint256) ^) 
"^24abdb5865df5079dcc5ac590ff6f01d5cl16edbcbfab4el95d9febd1114503da^ 






































你 可 以 在 Solidity 教程 中 阅读 更 多 关于 事件 ， 主 题 和 索引 的 内 容 。 
这 只 是 对 一 些 最 常见 任务 的 简单 介绍 。 在 RPC 维基 页 面 查看 可 用 RPC 方法 的 完整 
列表 。 


























8.5 Web3.js 








正如 我 们 在 之 前 的 案例 所 见 ， 使 用 JSON-RPC 界面 相当 单调 乏味 且 容 易 出 错 ， 尤 
其 是 在 处 理 ABI 的 时 候 。Web3. js 是 javascript 库 ， 在 以 太 坊 RPC 界面 顶端 。 
它 的 目标 是 提供 更 友好 的 界面 ， 减 少 出 错 机 会 。 

用 web3 部 署 Multiply? 合约 看 起 来 是 这 样 : 


var source = 'contract Multiply? { event Print (uint); function 
multiply(uint input) returns (uint) { Print(input 
var compiled - web3. eth. compile. solidity (source); 





























var code = compiled. MultiplyT. code; 

var abi = compiled. MultiplyT. info. abiDefinition; 

web3. eth. contract (abi). new([from: 
"Oxeb85a5557e5bdc18eel934a89d8bb402398ee26a^, data: code}, function 
(err, contract) { 

if (lerr && contract. address) 

console. log( deployed on:^, contract. address); 

j 

) ; 

deployed on: 0x0ab60714033847ad7f0677cc7514db48313976e2 








装载 一 个 部 署 的 合约 ， 发 送 交 易 : 


var source = 'contract Multiply? { event Print (uint); function 
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multiply(uint input) returns (uint) { Print(input 

var compiled = web3. eth. compile. solidity (source); 

var Multiply? = 

web3. eth. contract (compiled. Multiply7. info. abiDefinition); 

var multi = Multiply7. at ( 0x0ab60714033847ad7f0677cc7514db48313976e2^) 
multi.multiply. sendTransaction(6, {from: 
"Oxeb85a555'7e5bdc18ee1934a89d8bb402398ee26a^] ) 





注册 一 个 回调 ， 打 印 事件 创建 日 志 的 时 候 会 被 调用 。 


multi.Print(function(err, data) { console. log(JSON. stringify(data)) ]) 
{" address” :"0x0ab60714033847ad7£0677cc7514db48313976e2^, "args" : 
(^^:^21^), "blockHash" : "0x259c7dc0 














在 web3. js 维基 页 面 查 看 更 多 信息 。 





8.6 控制 台 

















geth 控制 台 提供 命令 行 界面 和 javascript 执行 时 间 。 它 可 以 连接 到 本 地 或 远程 
的 geth 或 eth 节点 。 它 会 装载 用 户 能 使 用 的 web3. js 库 。 这 会 允许 用 户 从 控制 
AH web3. js 部 署 智能 合约 并 和 智能 合约 互动 。 实 际 上 Wep3. js 章节 的 例子 可 以 
被 复制 进 控制 台 。 








8.7 查看 合约 与 交易 


有 儿 个 可 用 的 在 线 区 块 链 浏览 器 ， 能 让 你 查询 以 太 坊 区 块 链 。 
查看 列表 : PORBENIM dS. 





* EtherChain 


* EtherCamp 
。 EtherScan “为 测试 网 ) 





其 他 资源 
e EtherNodes - 节点 的 地 理 分 配 ， 由 客户 端 区 分 
* EtherListen - 实时 以 太 坊 交 易 可 视 器 和 可 听 咒 
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第 九 章 智能 合约 案例 实战 





以 太 坊 是 区 块 链 开发 领域 最 好 的 编程 平台 ， 而 truffle 是 以 太 坊 (Ethereum) 最 
受 欢迎 的 一 个 开发 框架 ， 这 是 我 们 介绍 truffle 的 原因 ， 实 战 是 最 重要 的 事情 ， 
这 篇 文章 不 讲 原 理 ， 只 搭建 环境 ， 运 行 第 一 个 区 块 链 程序 (Dapp) 。 























9.1 安装 truffle 


$ npm install -g truffle 


9.2 依赖 环境 


NodeJS 
访问 https://nodejs. org 官方 网 站 下 载 安 闭 











系统 : Windows, Linux or Mac OS X， 推 荐 Mac OS X， 不 建议 使 用 Windows, & 
碰 到 各 种 各 样 的 问题 ， 导 致 放 弃 。 











需要 安装 Ethereum 客户 端 ， 来 支持 JSON RPC API 调用 
开发 环境 ， 推 荐 使 用 EthereumJS 
TestRPC: https://github. com/ethereumjs/testrpc 











HE JA ^ 
安装 命令 ; 


$ npm install -g ethereumjs-testrpc 


9.3 新建 第 一 个 项 目 


$ mkdir zhaoxi 

$ cd zhaoxi 

$ truffle init 

默认 会 生成 一 个 MetaCoin 的 demo， 可 以 从 这 个 demo 中 学 习 truffle 的 架构 
项 目 目录 结构 如 图 : 
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app/ 
contracts/ 


environments/ 
test/ 
truffle.js 


项 目 所 有 文件 目录 如 图 : 


" Press ? for help import "ConvertLib.sol"; 














. (up a dir) 


app/ 
images/ 
javascripts/ 
app.js contract MetaCoin [i 
stylesheets/ mapping (address uint) balances; 
app. css 
index.html function MetaCoin() 1 
contracts, balances [tx.origin] 
ConvertLib.sol 
MetaCoin.sol 
environments/ function sendCoin(address receiver, uint amount) returns(bool sufficient) { 
development / (balances [msg.sender] amount) P 
config.js batLances [msg.sender] amount; 
production/ balances [receiver] amount; 
config.js H 
staging/ l 
config.js function getBalanceInEth(address addr) returns(uint){ 
test/ ConvertLib.convert(getBalance(addr),2) 
config.js } 
test/ function getBalance(address addr) returns(uint) { 
metacoin.js balances [addr]; 
truffle.js 





编译 项 目 


$ truffle compile 


bob8192 zhaoxi % truffle compile 

Checking sources... 

Compiling ConvertLib.sol... 

Compiling MetaCoin.sol... 

Writing contracts to ./environments/development/contracts 





部 署 项 目 
部 团 之 前 先 启动 TestRPC 
$ testrpc 


$ truffle deploy (在 Truffle 2.0 以 上 版 本 中 , 命令 变 成 了 : truffle migrate) 


bob8192 zhaoxi % truffle deploy 

Using environment development. 

No contracts updated; skipping compilation. 
Collecting dependencies... 


Deployed: ConvertLib to address: Ox1b04bf4deeb1b0b7ba8e8e50f2bc157708f2e20b 

Linking Library: ConvertLib to contract: MetaCoin at address: Ox1b04bf4deeb1b0b7ba8e8e50f2bc157708f2e20b 
Deployed: MetaCoin to address: 6xgbaeb7b99fd63f197865cb7b4d66406bd7182a4d 

Writing built contract files to ./environments/development/contracts 


$ truffle migrate 执行 结果 
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启动 服务 


$ truffle serve 





启动 服务 后 ， 可 以 在 浏览 器 访问 项 目 : 
http://localhost:8080/ ， 网 页 界面 如 下 : 





MetaCoin 


10000 META 


Send 


Amount: 


To Address: 


Send MetaCoin 








好 了 ， 第 一 个 区 块 链 程序 跑 起 来 了 ， 后 面 可 以 不 断 地 实践 深入 学 习 了 。 
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10 总 结 


10.1 写 这 本 书 的 初衷 


因为 接触 区 块 链 比较 早 ， 并 写 了 一 些 文章 ， 所 以 很 多 朋友 加 我 微 信 、QQ 聊 ， 
其 中 包括 开发 者 、 大 小 公司 的 创始 人 、 高 管 。 问 了 很 多 问题 ， 因 为 时 间 关 系 ， 我 
也 无 法 一 一 作答 。 另 外 ， 多 家 出 版 社 希 望 我 写 一 本 区 块 链 书籍 ， 我 知道 出 纸 质 书 
流程 很 长 ， 对 文字 也 要 字 基 句柄， 对 于 创业 者 来 说 , 确实 没有 那么 多 时 间 去 独 目 
写 一 本 书 ， 因 此 婉言 谢绝 了 。 
























































基于 以 上 原因 , 综合 考虑 下 来 决定 写 一 本 以 太 坊 电子 书 , 很 多 人 有 这 个 需求 ， 
所 以 会 很 有 价值 。 因 为 区 块 链 技 术 发 展 日 新 月 异 ， 因 此 《深入 浅 出 以 太 坊 》 是 一 
本 不 断 更 新 的 电子 书 ， 为 了 时 刻 保持 对 最 新 技术 的 跟 进 。 后 面 还 会 出 视频 教程 ， 
更 好 的 帮助 大 家 学 习 。 以 后 会 更 新 到 如 下 网 址 (目前 尚未 上 线 〉: 












































书籍 : book. wangxiaoming. com 
视频 : ethcast. com 
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